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1.0 


INTRODUCTION 


1.1  PURPOSE 

/  The  table«dr1ven  Assembly  Code  Analysis  Program  (ACAP)  Is  one 
component  In  a  family  of  automated  software  assessment  tools.  These  tools 
extract  Information  about  software  quality  features  of  the  target  software 
being  examined.  ACAP  provides  a  translator  which  can  be  modified  to  tailor  It 
to  the  specific  assembly  language  of  the  target  software.  Provision  Is  also 
made  In  the  ACAP  system  for  generating  reports  from  Information  collected  by 
other  language  translators. \ 

\ 

1.2  SCOPE  j 

This  document  ^Intended  to  be  an  Informal  technical  user  manual  to 
aid  the  analyst  perfopxnng  the  software  assessment.  It  Is  assumed  that  the 
user  Is  famlllap^wlth  the  host  computer  system  (VAX/VMS)  utilities, 
particularly  ,*Ne  EOT  editor,  and  the  FORTRAN  language.  An  understanding  of 
static  software  assessment  techniques,  computer  languages,  and  the  target 
systq*  software  Is  essential. 

1.3  DESCRIPTION 

\  . 

“/The  ACAP  system  has  been  developed  on  the  Digital  Equipment  VAX 
series  of  computers  utilizing  VMS.  The  ACAP  Is  written  entirely  In  VAX/DCL 
and  FORTRAN.  The  table  driven  ACAP  system  accepts  Input  defining  the 
mnemonics  of  the  assembler  language  to  be  analyzed.  Depending  on  the 
particular  language,  the  statement  parser  may  need  modification  and  subsequent 
linkage  within  the  code  translation  section  of  ACAP.  ACAP  determines 
Information  about  the  structure,  complexity,  use  of  Instructions  and 
variables,  and  selected  quality  parameters. 


A  general  purpose  report  writer  Interfaces  with  ACAP  and  other  code 
analysis  programs.  Data  generated  by  these  programs  are  provided  via  files  to 
the  Report  Writer.  These  files  supply  the  data  that  creates  the  software 
assessment  reports,  and  In  addition,  are  concatenated  Into  a  single  ‘"master 
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>>  The  ACAP  system  also  provides  the  capability  to  create  a  paginated, 
sequenced  listing  to  assist  In  software  assessment  activities. 

'  r  '  ’r?  /via-Mia-C 

The — following — sections-  descr1be^Athe  usage  of  ACAP,  define  the 
interfaces  among  each  of  the  subsystems,  describe  the  files  used  within  ACAP, 
and  illustrate  each  of  the  reports  created. 


2.0 


ACAP  USAGE 


The  ACAP  program  Is  run  by  typing  "@ACAP“.  A  main  menu  (Figure  2-1) 
is  then  displayed.  The  main  menu  is  a  list  of  act  ions/  functions  available  to 
the  user.  Each  of  the  selections  on  the  main  menu  is  described  in  the 
following  sections.  Every  menu  of  ACAP  has  a  help  file  which  explains  the 
usage  and  content  of  the  menu. 


ACAP  MAIN  MENU 


DISPLAY  Display  ACAP  Capabilities  ......  1 

INSTRUMENT  CODE  Instrument  Source  Code  .  2 

S/W  ASSESSMENT  Perform  Software  Assessment  .  3 

REPORT  WRITER  Run  ACAP  Report  Writer  .  4 

VIEW/PRINT  View/Print  Reports  .  5 

NEW  LANGUAGE  Create  New  Language  Capability  ....  6 

HELP  Display  Helpful  Information  .  H 

EXIT  TO  VMS  Terminate  ACAP  and  Exit  to  VMS  ....  E 

What  would  you  care  to  do  now?: 


FIGURE  2-1  -  ACAP  MAIN  MENU 
2.1  OISPLAY  ACAP  CAPABILITIES 

This  selection  assists  the  user  In  understanding  the  capabilities  of 
ACAP.  The  user  Is  presented  with  the  menu  shown  in  Figure  2-2  from  which  to 
select  the  Information  to  be  displayed. 
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ACAP  INTRODUCTION  MENU 


1  -  Overview 

2  -  System  Flow 

3  -  Languages  Currently  available 

for  software  assesment. 

E  -  Exit  to  ACAP  Main  Menu 
What  would  you  care  to  do  now? 


FIGURE  2-2  -  ACAP  INTRODUCTION  MENU 
4.2  INSTRUMENT  SOURCE  CODE 

This  selection  assists  the  user  In  Instrumenting  source  code  files 
for  subsequent  processing  by  ACAP.  Instrumentation  is  necessary  since  there 
are  inconsistencies  In  describing  how  or  where  a  procedure  might  begin  and  Is 
accomplished  by  Inserting  a  line  of  Information  Into  the  source  file  to  define 
segments  of  code  for  ACAP  to  assess  and  generate  reports.  This  eliminates 
ambiguities  and  assures  that  the  code  Is  processed  consistently  for  static 
analysis.  Instrumented  lines  are  not  regarded  as  source  by  ACAP.  This  Is 
explained  further  In  Appendix  B.  The  Instrument  Code  Menu  Is  shown  In  Figure 
2-3.  A  description  of  each  of  the  numbered  selections  In  this  menu  Is 
presented  In  the  following  paragraphs: 


INSTRUMENT  CODE 

1  -  Select  raw  source  code 

to  be  Instrumented. 

2  •  Define  Instrument/construct. 

3  -  Instrument 

4  -  Edit  Instrumented  source  code. 
H  -  Display  helpful  Information. 

E  -  Exit  to  ACAP  Main  Menu. 

What  would  you  care  to  do  now? 


FIGURE  2-3  -  INSTRUMENT  CODE  MENU 


This  selection  queries  the  user  for  the  name  of  the  source  file  to  be 
Instrumented.  The  name  must  be  a  legal  VMS  file  name  including  extension. 
The  specified  file  name  becomes  the  input  file  name  used  by  menu  Item  3. 

The  specified  file  may  reside  in  another  directory  In  which  case  the 
Directory  Path  should  be  entered  with  the  File  Name.  If  this  approach  is  used 
the  user  should  be  certain  they  have  appropriate  access  to  the  specified 
directory.  (Note:  The  combined  Directory  Path  and  File  Name  cr.nnot  exceed  31 
characters.) 

2.2.2  Define  Instrument/Construct 

This  selection  allows  the  user  to  define  the  constructs  to  be  used  In 
the  source  code  Instrumentation.  Upon  selection  of  this  menu  Item,  the  user 
Is  placed  Into  the  VAX  editor  with  a  template  of  a  namelist  file  displayed  for 
editing.  After  editing,  this  file  is  used  to  assist  in  instrumenting  the 
source  code  when  the  user  selects  menu  item  3. 

The  template  file  IRM.MTL  contains  comments  to  assist  the  user  In 
understanding  the  Instrumentation  process.  Below  Is  the  contents  of  this  file. 


S IRM 


The  Instrument  value  Is  the  string  which  the  code  translator  recognizes  as  the 
start  of  a  piece  of  Instrumentation.  It  should  not  be  recognizable  by  the 
compiler,  and  It  has  a  maximum  length  of  15  characters.  An  example  Instrument 
value  Is  "C**". 

INSTRUMENT_VALUE  -  * 

Code  constructs  are  pieces  of  source  code  which  hint  at  the  correct  place  to 
put  Instrumentation.  For  example  In  FORTRAN,  PROGRAM  Is  a  likely  place  for 
the  start  of  either  a  module  or  a  procedure.  SUBROUTINE  Is  a  likely  place  for 
the  start  of  a  procedure.  The  program  which  aids  In  the  Instrumentation 
process  searches  for  the  code  constructs  and  Inserts  a  line  containing  the 
INSTRUMENT_VALUE  in  front  of  the  line  on  which  the  code  construct  was  found. 
If  CODE_CONSTRUCT(N)  is  given  the  value  '  It  will  be  Ignored. 

C0DE_C0NSTRUCT1  «  '  \ 

C00E_C0NSTRUCT2  »  '  ', 

C0DE_C0NSTRUCT3  -  '  ' , 

SEND 


The  user  Is  expected  to  edit  the  values  as  appropriate  and  then  exit 
from  the  editor  in  the  normal  manner  which  returns  control  to  ACAP. 

2.2.3  Instrument 

This  selection  assists  the  user  In  doing  the  actual  source  code 

Instrumentation.  The  user  Is  prompted  to  specify  the  output  file  name  by  the 

query  'WHAT  WOULD  YOU  LIKE  TO  CALL  THE  INSTRUMENTED  SOURCE?'.  The  name  must 

be  a  legal  VMS  file  name  Including  extension.  No  Directory  Path  should  be 

entered  here,  the  file  must  reside  In  the  default  directory.  After  the  output 

file  name  Is  entered,  the  Input  file  specified  using  menu  Item  1  Is  opened, 

and  each  line  In  the  source  file  is  searched  for  the  character  strings 

specified  as  CODEJCONSTRUCTS  above.  If  a  C0DE_C0NSTRUCT  Is  found,  a  single 

line  containing  the  INSTRUMENT  VALUE  Is  written  to  the  output  file  followed  by 

-6- 


This  selection  allows  the  user  to  complete  the  Instrumentation 
process  started  above.  The  user  Is  placed  Into  the  VAX  editor  In  order  to 
edit. the  file  output  above.  The  user  Is  expected  to  utilize  the  search 
function  of  the  editor  to  locate  the  automatically  Instrumented  lines 
containing  the  I NSTRUMENT_VALUE  and  complete  each  of  these  lines  as  explained 
In  Appendix  B  of  this  document.  Exiting  from  the  editor  In  the  normal  manner 
returns  control  to  ACAP. 

2.3  SOFTWARE  ASSESSMENT 

Selecting  this  Item  allows  the  user  to  perform  software  assessment  on 
an  Instrumented  source  program.  The  menu  shown  In  Figure  2-4  Is  displayed  to 
the  user  from  which  the  user  Is  required  to  select  the  appropriate  language. 


-ACAP-  SOFTWARE  ASSESSMENT 
ASSEMBLY  LANGUAGE  CAPABILITIES 


1  -  6800 

6  - 

11  - 

2  -  M68000 

7  - 

12  - 

3  -  SKC 

8  - 

13  - 

4  -  PDP11 

9  - 

14  - 

5  - 

10  - 

15  - 

If  the  Language  you  want  Is  not  available.  Press  RETlfflN  key. 
Please  Select  Assembly  Language  for  ACAP  S/W  Assessment 


FIGURE  2-4  -  ACAP  ASSEMBLY  LANGUAGES 


A  message  Is  displayed  If  the  language  Is  not  currently  available 


A  description  of  each  of  the  numbered  selections  on  this  menu  Is 
presented  In  the  following  paragraphs.  After  selection  of  a  language  the  menu 
shown  In  figure  2.5  is  displayed: 


SOFTWARE  ASSESSMENT  MENU 

1  -  Select  Instrumented  Source  Code 

to  be  Processed  by  ACAP 

2  -  Process  Code  and  Create  Master  File 
H  -  Display  Helpful  Information 

E  -  Exit  to  ACAP  Main  Menu 
What  would  you  care  to  do  now? 


FIGURE  2-5  -  SOFTWARE  ASSESSMENT  MENU 

2.3.1  Select  Instrumented  Source  Code  to  be  Processed  by  ACAP 

This  selection  queries  the  user  for  the  file  name  of  the  Instrumented 
source  code  as  follows: 


Select  the  Instrumented  Source  Code 
Enter  the  Filename 

(Note:  The  file  must  reside  In  the  default  directory.): 
Enter  the  Name  of  the  Program  In  That  File 
(Must  be  a  Legal  YMS  Filename  Without  Extension): 


The  Filename  Is  used  to  locate  the  Instrumented  source  which  must 
reside  In  the  default  directory.  A  blank  response  to  this  Inquiry  Is  not 
allowed  and  will  cause  the  prompt  to  reoccur. 


Writer 


The  program  name  Is  used  to  name  report  files  output  by  the  Report 


The  user  is  then  queried  for  the  classification  of  the  program  source 
as  follows: 


If  the  user  enters  something  other  than  one  of  the  legal 
classifications,  the  message  "That  is  not  a  legal  classification.  Please  try 
again."  will  be  displayed. 

2.3.2  Process  Code  and  Create  Master  File 

This  selection  processes  the  instrumented  source  code  in  the  file 
specified  by  menu  item  2  through  the  Code  Translator  and  the  Static  Analyzer 
automatically  generating  all  the  data  necessary  for  all  the  reports.  After 
completion  of  the  translation  and  static  analysis,  the  user  is  prompted  to 
enter  a  name  for  a  Master  File  to  contain  all  the  output  data  for  the  reports. 
It  is  recommended  that  the  Master  File  name  has  an  extension,  such  as  MAS, 
that  follows  a  user-defined  convention  to  alloweasy  identification  of  Master 
Files. 

2.4  REPORT  WRITER 

This  selection  allows  the  user  to  select  specific  ACAP  reports  to  be 
generated.  The  user  is  first  asked  "WHAT  IS  THE  NAME  OF  THE  MASTER  FILE?:". 
The  name  must  be  a  legal  VMS  file  name  Including  extension.  After  specifying 
the  file  name,  the  menu  shown  in  Figure  2-6  is  displayed  to  the  user. 


CREATE  REPORTS 


1.  Module  Report 

2.  Summary  and  Compliance  Reports 

3.  Software  Quality  Metrics  Report 

4.  Calls  Report 

5.  Structure  Diagrams 

6.  Undefined  Externals  Report 

7.  Variable  Usage  Report 

8.  Sequenced/Paginated  Listing 

9.  Macro  Usage  Report 

Select  the  reports  to  generate  (e  ■  quit,  h  ■  help,  r  ■  run): 


FIGURE  2-6  -  ACAP  REPORT  GENERATION  MENU 

To  select  a  report,  the  user  types  the  report  number,  as  shown  on  the 
menu,  followed  by  a  RETURN.  The  selected  report  title  Is  then  highlighted 
using  Inverse  video.  Once  selected,  a  report  can  be  deselected  by  again 
typing  the  report  number  followed  by  a  RETURN  and  the  report  title  will  no 
longer  be  high  lighted.  Any  number  of  reports  can  be  selected  for  generation. 

After  the  user  has  selected  all  the  reports  he  desires,  the  user 
types  'R  <RETURN>‘  to  have  the  reports  run. 

To  obtain  help,  the  user  types  'H  <RETURN>'. 

To  exit  report  generation  and  return  to  the  main  menu,  the  user  types 
•E  <RETURN> 1 . 

A  sample  of  all  the  reports  Is  Included  In  Section  6.  Note  that  the 
Information  In  the  reports  depends  on  the  Information  In  the  master  file.  Not 
all  data  will  or  can  be  extracted  by  the  Code  Translator/Static  Analyzer  for 
all  languages.  For  Information  on  the  metrics  that  are  being  extracted  for  a 
particular  language,  see  the  appropriate  appendix. 


The  Module  Report  (In  a  file  named  "Program_name.MOD")  lists  the 
module  names,  the  number  of  procedures  In  each  module,  the  procedure  names  and 
the  page  number  of  the  procedure  In  the  sequenced  paginated  listing. 

2.4.2  Summary  and  Compliance  Reports 

The  Summary  and  Compliance  Reports  (In  a  file  named 

"Program_name.CPL)  indicate  the  degree  of  compliance  that  the  software  being 
analyzed  has  with  selected  metrics.  The  Summary  Report  lists  the  number  of 
compliant  and  non-compl 1  ant  procedures,  the  percent  of  compliant  and 

non-compllant  procedures,  the  total  value,  and  the  average  value  for  each 

metric.  The  Compliance  Report  consists  of  two  tables.  The  first  Is  the 

Numerical  Compliance  Table  which  lists  the  value  of  each  metric  for  each 
procedure.  The  second  Is  the  Compliance  Table  which  Indicates  whether  each 
procedure  Is  compliant  with  the  compliance  values. 

After  selection,  the  following  question  Is  displayed  to  the  user: 
WOULD  YOU  LIKE  TO  CHANGE  THE  COMPLIANCE  VALUES?  If  the  user  enters  'Y\  he 
will  be  able  to  change  compliance  values  as  discussed  In  Section  2.4.2. 1; 
otherwise,  the  user  Is  prompted  to  select  the  metrics  for  the  Summary  and 

Compliance  Reports  using  the  menu  shown  In  Figure  2-7. 


Select  the  metrics  for  the  summary  report. 


1.  Number  of  Lines  In  the  15. 

Abstract  16. 

2.  Number  of  Comment  Lines  17. 

3.  Number  of  Executable  Lines  18. 

4.  Number  of  Non-Executable  19. 

Lines  20. 

5.  Number  of  Lines  21. 

6.  Number  of  Comments  for  Exec  22. 

Lines  23. 

7.  Number  of  Comments  for  24. 

Non-Exec  Lines  25. 

8.  Number  of  In  Line  Comments  26. 

9.  X  of  Executable  Lines  27. 

Commented  28. 

10.  X  of  Non-Executable  Lines  29. 

Commented  30. 

11.  Maximum  Consecutive  Lines  31. 

W/0  Comm  32. 

12.  Number  of  Executable  33. 

Statements  34. 

13.  Number  of  Non-Executable 

Statements  35. 

14.  Number  of  Multi -Line 

Statements 


Which  metric  would  you  like  In  the 


Number  of  Multi -Statement  Lines 
Number  of  Entry  Points 
Number  of  Exit  Points 
Number  of  Forward  Branches 
Number  of  Backward  Branches 
Number  of  Branches  out  of  Routine 
Number  of  Conditional  Branches 
Number  of  Unconditional  Branches 
Number  of  Nodes 
Number  of  Paths 
McCabe's  Cyclomat 1c 
Number  of  Lines  Skipped 
Number  of  Includes 
Number  of  Unique  Operators 
Number  of  Operators  Used 
Number  of  Unique  Operands 
Number  of  Operands  Used 
Lines  of  Code  (Primary  Language) 
Lines  of  Code  (Embedded  Language) 
Primary  vs.  Embedded  Language 
Switches 

Number  of  Variables  In  a  Procedure 


report  (e  ■  exit,  h  »  help): 


FIGURE  2-7  -  METRIC  SELECTION 


To  select  a  metric,  the  user  types  the  metric  number,  a*s  shown  on  the 

»  •* 

menu,  followed  by  a  RETURN.  The  selected  metric  Is  then  highlighted  using 
Inverse  video.  Once  selected  a  metric  can  be  deselected  by  again  typing  the 
metric  number  followed  by  a  RETURN.  Only  ten  (10)  metrics  may  be  selected  at 
a  time.  Error  messages  will  appear  If  the  selection  of  an  eleventh  metric  Is 
attempted  or  If  an  attempt  Is  made  to  select  a  metric  which  has  been 
determined  to  be  Invalid  for  the  selected  language. 

To  obtain  help,  the  user  types  'H  <RETURN>’. 


To  terminate  selection  of  the  metrics  and  return  to  the  main  menu, 
the  user  types  'E  <RETURN>*. 
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2.4.2. 1  Changing  Compliance  Values 

The  user  Is  placed  In  the  EOT  editor  in  keypad  mode  and  allowed  to 
edit  the  REPORT. NML  file.  This  Is  a  Namelist  file  used  In  creating  the 
Compliance  and  Summary  Reports.  The  following  is  displayed  to  assist  the  user 
In  the  editing  process: 

$SUM_REP_CONFIG 

!How  to  Change  the  Wording  of  the  Report  Headings  and  the  Compliance  Values 
! 

!The  report  heading  for  each  metric  consists  of  the  two  lines:  C0L_HD_LN1 
land  C0L_HD_LN2.  To  change  the  heading  find  the  array  entry  which  corresponds 
I  to  the  desired  metric,  and  edit  the  headings.  Do  not  change  the  total  number 
!of  characters  or  the  report  will  not  look  right. 

!The  compliance  value  is  stored  In  COMPLY_VAL.  To  change  the  numerical  value 
Iflnd  the  correct  array  entry  and  change  It. 

!The  LT  GT  FLAG  Is  tested  to  determine  If  the  value  of  the  metric  must  be  <■ 
for  >*  the  compliance  value.  If  LTJBT_FLA6  Is  given  a  value  of  T  or  TRUE, 
Ithen  the  metric  must  be  greater  than  or  equal  to  the  compliance  value.  If 
!1t  Is  given  a  value  of  F  or  FALSE  then  the  metric  must  be  less  than  or  equal 
!to  the  compliance  value. 

! 

!The  totals  of  some  of  the  metrics  are  given  In  the  summary  report.  If  the 
{variable  SH0W_T0TAL  Is  TRUE  then  the  total  Is  shown.  If  it  Is  FALSE  then  the 
! total  Is  not  shown. 

1  Please  look  for  the  appropriate  entries  below: 

!  Number  of  lines  In  the  abstract 
C0L_HDJLN1(1)  -  'ABSTRACT |', 

C0L_H0_LN2{1)  ■  'LINES  |\ 

COHPLYJVAL(l)  »  3, 

LT_GT_FLAG(1)  -  T, 

SHOW  TOTAL(l)  »  T, 


!  Number  of  comment  lines 
C0L_HD_LN1(2)  ■  ‘COMMENT  |‘, 
C0L_HD_LN2(2)  -  ‘  LINES 
COMPLY_VAL(2)  -  100, 

LT_GT_FLAG(2)  -  F, 

SHOW  TOTAL (2)  -  T, 

!  Number  of  executable  lines 
C0L_HDJLN1(3)  •  '  EXECU  |‘, 
C0L_HD_LN2(3)  -  *  LINES  |\ 
C0MPLY_VAL(3)  «  100, 

LT_GT_FLAG(3)  -  F, 

SHOW_TOTAL(3)  «  T, 

!  Number  of  non-executable  lines 
C0L_H0J.N1 (4)  -  ’NON-EXEC) * , 
C0L_HD_LN2(4)  -  ‘  LINES  |‘, 
C0MPLY_VAL(4)  -  100, 

LT_GT_FLAG(4)  •  F, 

SH0W_T0TAL(4)  -  T, 

!  Total  number  of  lines 
C0L_HD_LN1(5)  -  *  TOTAL  )', 
C0L_HD_LN2(5)  -  '  LINES  |\ 
C0MPLY_VAL(5)  «  100, 

LT_GT_FLAG(5)  «  F, 

SH0W_T0TAL(5)  •  T, 

!  Number  of  comments  In  exec,  stmts. 
C0L_H0J.N1  (6)  •  'COUNTS  | ' , 
C0L_HD_LN2(6)  •  ‘(EXECU.) 
C0MPLY_VAL(6)  -  200, 

LT_GT_FLAG(6)  -  F, 

SH0W_T0TAL(6)  •  T, 

!  Number  of  comm.  In  non-exec,  stmts. 
C0L_H0J.N1 (7)  -  'COMMENTS 
C0L_HD_LN2(7)  •  ' (NON-EX )|‘, 
C0MPLY_VAL(7)  -  50, 

LT_GT_FLAG(7)  -  T, 

SHOW  T0TAL(7)  •  T, 
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!  Number  of  Inline  comments 
C0L_HDJ.N1  (8)  »  'IN-LINE  |', 
C0L_HD_LN2{8)  -  'COMMENTS! * , 
C0MPLY_VAL(8)  -  100, 

LT_GT_FLA6(8)  •  F, 

SH0W_T0TAL(8)  -  T, 

!  %  of  executable  line  commented 
C0L_H0J.N1 (9)  -  '%  COMM.  |', 
C0L_HD_LN2(9)  -  '  EXEC.  |', 
C0MPLY_VAL(9)  »  100, 

LT_GT_FLAG(9)  «  T, 

SH0W_T0TAL(9)  »  F, 

!  %  of  non-executable  line  commented 
C0L_HD_LN1  ( 10)  -  '%  COMM.  |\ 
C0L_H0_LN2(10)  «  '  NON-EX  J  * , 
COMPLY_VAL(10)  -  100, 

LT_GT_FLAG<10)  «  T, 

SH0H_T0TAL(10)  -  F, 

!  Number  of  consecutive  lines  w/o  comm 
C0L_HD_LN1(11)  ■  'MAX  H/0  |', 
C0L_H0_LN2(11)  «  'COMMENT  |\ 
C0MPLY_VAL(11)  •  4, 

LT_GT_FLAG(11)  »  F, 

SH0H_T0TAL(11)  «  F, 
i  Number  of  executable  statements 
C0L_HD_LN1  (12)  ■  '  EXECU.  |\ 
C0L_HD_LN2(12)  -  '  STMTS.  | ' . 
C0MPLY_VAL(12)  «  100, 

LT_GT_FLAG(12)  •  F, 

SH0W_T0TAL{12)  •  T, 

!  Number  of  non-executable  statements 
C0L_H0J.N1(13)  -  '  NON-EX  | * , 
C0L_HDJ.N2(13)  -  '  STMTS.  | ', 
C0MPLY_VAL{13)  -  50, 

LT_GT_FLAG(13)  -  F, 

SHOW  T0TAL(13)  -  T, 


!  Number  of  multi -line  statements 
C0L_HD_LN1(14)  -  'MLT-LINE | ' , 
C°L_H0_LN2(14)  ■  *  STMTS.  | * , 
C0MPLY_VAL{14)  ■  0. 

LT_6T_FLAS(14)  «  F, 

SH0W_T0TAL(14)  ■  T, 

!  Number  of  multi -statement  lines 
C0L_HD_LN1(15)  -  'MLT-STMTj ' , 
C0L_HD_LN2(15)  «  '  LINES  | * , 
C0MPLY__VAL(15)  -  0, 

LT_GT_FLA6(15)  -  F. 

SH0W_T0TAL(15)  »  T, 

!  Number  of  entry  points 
C0L_HD_LN1(16)  «  '  ENTRY  |\ 
C0L_HD_LN2(16)  »  'POINTS  |', 
C0MPLY_VAL(16)  -  1, 

LT_GT_FLAG(16)  -  F, 

SH0N_T0TAL(16)  -  T, 

!  Number  of  exit  points 
C0L_HD_LN1(17)  »  '  EXIT  | ' . 
C0L_HD_LN2(17)  -  '  POINTS  |', 
C0MPLY_VAL(17)  «  1. 

LT_GT_FLAG(17)  -  F, 

SH0H_T0TAL(I7)  -  T, 

!  Number  of  forward  branches 
C0L_H0_LN1(18)  •  'FORWARD  |\ 
C0L_HD_LN2(18)  ■  'BRANCHES) 1 , 
C0MPLY_VAL(18)  -  0, 

LT_GT_FLAG(18)  ■  F, 

SH0W_T0TAL(18)  -  T, 

!  Number  of  backward  branches 

C0L__H0 _ LN1  ( 19)  -  'BACKWARD | ' , 

C0LJ1D_LN2(19)  -  'BRANCHES! 
C0MPLY_VAL(19)  -  0, 

LT_GT_FLA6(19)  ■  T, 

SHOW  TOTAL (19)  -  T, 


!  Number  of  branches  out  of  routine 
C0L_HD_LN1(2Q)  »  'OUTWARD  |'f 
C0L_HD_LN2(20)  ■  ' BRANCHES | ' , 
C0MPLY_VAL(20)  ■  0, 

LT_GT_FLAG(20)  «  F, 

SH0W_T0TAL(20)  -  T, 

!  Number  of  conditional  branches 
C0L_HD_LN1(21)  -  '  COND.  |', 
C0L_HD_LN2 (21 )  ■  'BRANCHES) * , 
C0HPLY_VAL(21)  »  0, 

LT_GT_FLAG(21)  ■  F, 

SH0W_T0TAL(21)  »  T, 

!  Number  of  unconditional  branches 
C0L_HDJ.N1 (22)  »  '  UNCOND.  | • . 
C0L_HD_LN2(22)  *  '  BRANCHES  |\ 
C0MPLY_VAL(22)  -  0, 

LT_GT_FLAG(22)  -  F, 

SH0W_T0T AL ( 22)  -  T, 

!  Number  of  nodes 
C0L_HDJ.N1  (23)  »  '  NODES  |\ 

C0L_HD_LN2(23)  ■  '  )', 

C0MPLY_VAL(23)  -  0, 

LT_GT_FLAG(23)  •  F, 

SH0W_T0TAL(23)  ■  T, 

!  Number  of  paths 
C0L_HD_LN1(24)  •  '  PATHS  |'t 

C0L_HDJ.N2(24)  •  '  |', 

C0MPLY_VAL(24)  ■  0, 

LT_GT_FLAG(24)  ■  F, 

SH0W_T0TAL(24)  •  T, 

i  McCabe's  cyclomat 1c 
C0L_H0_LN1(25)  •  'McCA8ES  |\ 
C0L_H0_LN2(25)  «  'C0MPLEX.|', 
C0MPLY_VAL(25)  •  10, 

LT_GT_FLAG(25)  -  F, 

SHOW  TOTAL (25)  •  F, 
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1  Number  of  lines  skipped 

COL _ HD _ LN1  (26)  «  '  LINES  |\ 

C0L_HD_LN2(26)  »  *SKIPPE0| ' , 
C0MPLY_VAL(26)  •  0, 
LT_GT_FLAG(26)  -  F, 
SH0W_T0TAL(26)  ■  T, 

!  Number  of  Includes 
C0L_HD__LN1(27)  «  'INCLUDES!  * . 
C0L_HDJLN2(27)  »  '  |', 

C0MPLY_VAL(27)  «  0, 
LT_GT_FLAG(27)  ■  F, 
SHOH_TOTAL(27)  -  T, 

!  Number  of  unique  operators 
C0L_HD_LN1(28)  «  *  UNIQUE 
C 0L_HDJLN2 (28 )  *  'OPERAT.  |', 
C0MPLY_VAL(28)  ■  0, 
LT_GT_FLAG(28)  *  F, 
SH0W_T0TAL(28)  •  T, 

!  Number  of  operators  used 
C0L_HDJLNi(29)  -  'OPERAT.  |', 
C0L_HD_LN2(29)  ■  '  USED  |*, 
C0MPLY_VAL(29)  »  0, 
LT_GT_FLAG(29)  »  F, 
SHOW_TOTAL(29)  »  T, 

!  Number  of  unique  operands 
C0L_H0_LN1(30)  »  '  UNIQUE  |', 
C°L_HD_LN2(30)  •  'OPERANDS |' , 
C0MPLY_VAL(30)  ■  0, 
LT_GT_FLAG(30)  «  F, 
SH0W_T0TAL(30)  ■  T, 

!  Number  of  operands  used 
C0L_HDJ.N1(31)  ■  '  OPERANDS  |* 
C0L_HDJLN2(31)  ■  '  USED  |' 
C0HPLY_VAL(31)  •  0, 
LT_GT_FLAG(31)  -  F, 

SHOW  TOTAL (31)  ■  T, 


!  Number  of  lines  of  primary  code 
C0L_HD_LN1(32)  -  'LINES  OF | ' , 
C0L_HD_LN2(32)  -  'PRIMARY  | ' , 
C0MPLY_VAL(32)  »  0, 

LT_GT_FLA6(32)  -  F, 

SH0W_T0TAL(32)  -  T, 

!  Number  of  lines  of  embedded  code 
C0L_HD_LN1(33)  «  'LINES  OF | ' , 
C0L_HD_LN2(33)  -  'EMBED0ED| ' , 
COMPLY_VAL(33)  -  0, 

LT_GT_FLAG ( 33 )  -  F, 

SH0W_T0TAL(33)  «  T, 

!  Number  of  switches:  Primary  vs.  Embedded 
C0L_HD_LN1(34)  -  'SWITCHES  |\ 

C0L_HD_LN2(34)  -  'PRI/EMBO  |', 

C0MPLY_VAL(34)  -  0, 

LT_GT_FLAG(34)  •  F, 

SH0W_T0TAL(34)  -  T. 

!  Number  of  variables  In  a  procedure 
C0L_HUJ.N1 (35)  »  'NUM.  OF  | ' , 

C0L_HD_LN2 ( 35 )  -  '  VARS.  |'f 
C0MPLY_VAL(35)  «  50, 

LT_GT_FLAG(35)  -  F, 

SHOW_TOTAL(35)  »  T, 

!  The  rest  are  not  used. 

C0L_HD_LN1 (36)  -  '  | ' , 

C0L_HDJLN2 ( 36 )  -  '  |\ 

C0MPLY_VAL(36)  -  0, 

LT_GT_FLAG(36)  -  F, 

SHOW  TOTAL (36)  ■  T, 


COL _ HD _ LN1  ( 50)  -J  |  * , 

C0L_HD_LN2(50)  «  '  |*. 

C0MPLY_VAL(50)  -  0, 

LT_GT_FLAG(50)  -  F, 

SH0W_T0TAL(50)  *  T. 

YES  *  '  YES  | * , 

NO  «  '  NO  r, 

BLANK  *  ' 

SEND 

Exiting  from  the  editor  In  the  normal  manner  returns  control  to  ACAP. 
The  user  will  then  be  able  to  select  the  metrics  for  the  Summary  and 
Compliance  Reports  as  discussed  previously. 

2.4.3  Software  Quality  Metrics  Report 

The  Software  Quality  Metrics  Report  (In  file  name 
“Program_name.SQM")  itemizes  all  of  the  metrics  listed  in  Figure  2-7  for  each 
procedure.  Not  all  metrics  can  be  collected  for  all  languages.  If  a  metric 


has  been  determined  to  be  "not  applicable"  for  a  given  language  an  entry  Is 
made,  by  the  user,  in  the  "INIT_MET"  Namelist  which  resides  In  the  Parser 
Table.  (See  Appendix  D.)  The  entry  Is  given  a  value  of  -1  and  the  metric 
will  not  be  processed  further.  "N/A"  for  "not  applicable"  will  be  printed  on 
the  report. 

2.4.4  Calls  Report 

The  Calls  Report  (In  a  file  named  "Programm_name.CAL")  lists  all  the 
Internal  calls  from  each  procedure  within  a  module. 

2.4.5  Structure  Diagrams 

The  Structure  Diagrams  (In  a  file  named  “Program_name.STR")  are 
generated  for  each  procedure  showing  up  to  fourteen  (14)  levels  of  procedure 
calls. 


2. 


Undefl ned  Externals  Report 


The  Undefined  Externals  Report  (in  a  file  named  "Program_name.EXT") 
lists  all  the  unresolved  external  references  in  each  procedure. 

2.4.7  Variable  Usage  Report 

Variable  Usage  Reports  (in  a  file  named  "Program_name.VUR")  are 
generated  for  both  local  and  global  variables.  For  global  variables,  the 
report  lists  each  global  variable,  the  variable  type  (if  applicable),  the 
procedures  In  which  it  appears,  and  the  number  of  times  It  is  modified, 
referenced,  tested,  defined,  or  passed  as  an  argument  In  the  procedure.  For 
each  procedure,  the  report  lists  all  variables,  whether  they  are  local,  global 
or  passed  to  the  procedure  as  arguments,  their  variable  type,  and  the  number 
of  times  they  are  modified,  referenced,  tested,  defined  or  passed  as  an 
argument  In  the  procedure. 

2.4.8  Sequenced/Paginated  Listing 

A  Sequential  Listing  (in  a  file  named  “Program_name.LST")  is 
generated  for  each  procedure  numbering  each  source  line  and  printing  a  page 
number  on  each  page.  These  page  numbers  are  referenced  on  the  Module  Report. 

2.4.9  Macro  Usage  Report 

Macro  Usage  Report  (In  a  file  named  "Program_nameM.MURB)  lists  all 
Macro  Definitions  and  usage  found  In  the  Instrumented  source. 

2.5  VIEW  AND  PRINT 

This  selection  allows  the  user  to  either  view  or  print  reports 
generated  by  the  Report  Writer.  The  menu  shown  In  Figure  2-9  Is  displayed  to 
the  user. 


a 


VIEW/PRINT  REPORTS 

1.  Module  Report 

2.  Summary  and  Compliance  Reports 

3.  Software  Quality  Metrics  Report 

4.  Calls  Report 

5.  Structure  Diagrams 

6.  Undefined  External  Report 

7.  Variable  Usage  Report 

8.  Sequenced/Paginated  Listing 

9.  Macro  Usage  Report 

Select  the  reports  to  view/print  (e  ■  exit,  h  ■  help, 
v*v1ew,  p»pr1nt): 


FIGURE  2-9  -  VIEW/PRINT  REPORT  MENU 

To  select  a  report,  the  user  types  the  report  number,  as  shown  on  the 
menu,  followed  by  a  RETURN.  The  selected  report  title  Is  then  highlighted 
using  Inverse  video.  Once  selected,  a  report  can  be  deselected  by  again 
typing  the  report  number  followed  by  a  RETURN,  and  the  report  title  will  no 
longer  be  highlighted.  Any  number  of  reports  can  be  selected. 

After  selection  Is  complete,  the  user  types  'V  (RETURN)'  to  view  the 
reports  or  'P (RETURN) '  to  print  the  reports. 

When  viewing  reports,  the  user  Is  placed  in  the  VAX  editor  and  so  has 
all  the  editor  capabilities  available  for  viewing  the  selected  reports.  To 
aid  the  user  In  viewing  reports  a  special  function  key  has  been  established  to 
set  the  screen  to  132  character  mode.  The  user  simply  types  'Gold'  'CTRL  W' 
and  132  mode  will  be  set.  Upon  exit  the  screen  will  automatically  reset  to  80 
character  mode. 

Upon  completion  of  the  view  or  print  process,  the  main  view  and  print 
menu  Is  displayed  to  the  user  for  continuation  of  the  selection  process.  To 
obtain  help,  the  user  types  'H(RETURN)’.  To  exit,  the  user  types  'E(RETURN)'. 
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NEW  LANGUAGE 

This  selection  allows  the  user  to  develop  the  capability  to  process 
new  languages  for  ACAP  and  to  manually  step  through  the  software  assessment 
process.  The  menu  shown  in  Figure  2-8  Is  displayed  to  the  user. 


NEW  LANGUAGE  MENU 

1  -  Set  up  Parser  Tables 

2  -  Select  Instrumented  source  code 

file  to  be  processed. 

3  -  Run  Code  Translator 

4  -  Run  Static  Analyzer 

5  -  Create  a  Master  File 

H  -  Display  helpful  information. 

E  -  Exit  to  ACAP  Main  Menu“ 

What  would  you  care  to  do  now?" 


FIGURE  2-8  -  NEW  LANGUAGE  MENU 


2.6.1  Set-up  Parser  Tables 

To  set-up  the  parser  table,  the  user  Is  allowed  to  edit  an  existing 
parser  table.  (For  an  example  of  a  Parser  Table  see  Appendix  D.)  The  user  is 
placed  in  the  VAX  EOT  editor  In  keypad  mode  and  can  use  normal  editing 
commands  to  create  the  desired  new  parser  table.  The  following  Information  Is 
stored  In  the  table: 

Variable 


Name 

Type 

(Dimension) 

Description 

N  ASSM 

Int  4 

Number  of  assembly  language  mnemonics. 

ASSM  INSTS 

Char  8 

(200) 

Assembly  language  mnemonics. 

ASSM- CODES 

Int  4 

(200) 

Code  for  each  mnemonic. 

ASSM"MODES 

Int  4 

(200) 

Address  mode  for  each  mnemonic. 

ASSM- SPECS 

Int  4 

(200) 

Special  Information  about  the 

Instruction. 

N  USER 

Int  4 

Number  of  user-defined  Instructions. 

USER  INSTS 

Char  8 

(100) 

User  mnemonics. 

USERHCODES 

Int  4 

(100) 

Code  for  each  user  Instruction. 

USER“M00ES 

Int  4 

(100) 

Address  mode  for  each  user 

Instruction. 

USER  SPECS 

Int  4 

(100) 

Special  Information  about  each  user 

Instruction. 


2.6.2  Select  Instrumented  Source  Code  File  to  be  Processed 


This  selection  queries  the  user  for  the  filename  of  the  instrumented 
source  code  as  follows: 

Select  the  Instrumented  Source  Code 
Enter  the  Filename: 

What  is  the  name  of  the  program  in  that  file: 

The  program  name  allows  different  source  files  to  be  analyzed  for  a 
given  program.  ("Program_NameM  is  used  for  all  report  names.) 

2.6.3  Run  Code  Translator 

This  selection  runs  the  Code  Translator.  For  more  information  on  the 
Code  Translator,  see  Section  3. 

2.6.4  Run  Static  Analyzer 

This  selection  runs  the  Static  Analyzer.  For  more  information  on  the 
Static  Analyzer,  see  Section  3. 

2.6.5  Create  Master  File 

This  selection  creates  one  file  containing  all  of  the  files  from  the 
ACAP  run.  The  user  is  asked  for  the  name  of  the  Master  File,  and  a  check  is 
made  and  a  warning  issued  if  the  file  already  exists.  The  Master  File  is 
created  from  the  ACAP  output  files  from  the  most  recently  completed  ACAP  run. 
If  the  user  does  not  specify  an  extension  such  as  MAS,  an  extension  of  NML  Is 
appended  to  the  user-supplied  name.  The  Master  File  Is  described  In  Appendix 
A. 


2.7  HELP 

The  user  may  obtain  helpful  Information  In  either  of  two  ways: 

1.  Entering  'H  <RETURN>'  displays  text  explaining  all  selections 
available  on  this  menu. 


2.  Entering  *H'  with  C *  1  *  or  '2'  or  ...'E']  <RETURN>  displays  text 
associated  only  with  the  specified  menu  item. 

2.8  TERMINATE  ACAP  AND  EXIT  TO  VHS 

This  selection  terminates  ACAP  execution  and  returns  the  user  to  the 
VMS  system. 
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3.0  THE  ACAP  SYSTEM 

The  structure  of  the  ACAP  system  Is  shown  In  Figure  3-1.  The  system 
consists  of  an  executive  and  four  functional  modules: 

•  Input  Processor 

•  Code  Translator 

•  Static  Analyzer 

•  Report  Writer 

The  executive  functions  as  an  Interface  to  the  user  of  ACAP  and  as  a 
controller  of  the  ACAP  system  modules.  These  functions  are  performed  by  means 
of  a  main  menu  feature  and  command  procedures.  These  procedures  assist  the 
user  In  selecting  Input  files  and  options  for  subsequent  processing.  The 
Interface  between  the  modules  Is  accomplished  using  the  various  data  files 
shown  In  the  figure.  These  files  consist  of  either  “Namelist"  formatted  data 
or  sequential  data. 

3.1  ACAP  INPUT  PROCESSOR 

The  ACAP  executive  passes  control  to  this  module  when  the  user 
selects  main  menu  Item  2,  Instrument  Code,  as  discussed  In  the  previous 
section  on  ACAP  usage. 

An  Interface  diagram  for  the  Input  Processor  Is  shown  In  Figure  3-2. 


Source  File 
Instrumentation 
File  IRM.NMl  - 


Instrumented  Source  File 


FIGURE  3-2  -  INPUT  PROCESSOR 
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The  Input  Processor  accepts  the  following  input: 


a.  Source  file  -  a  file  containing  the  assembly  language  source  to 
be  analyzed. 

b.  The  instrumentation  file  (IRM.NML). 

3.1.2.  Processing 

The  Input  Processor  performs  the  function  of  semi-automatical ly 
Instrumenting  source  files,  which  Is  further  explained  in  Appendix  B. 

The  Input  Processor  consists  of  the  procedures  shown  in  the  structure 
charts  of  Section  4.0.  INSTRM  generates  an  Instrumented  source  file  by 
searching  for  user-defined  constructs  and  Inserting  the  specified  Instru¬ 
mentation  value,  as  defined  In  IRM.NML. 

3.1.3  Outputs 

The  Input  Processor  generates  the  following  output: 

a.  Instrumented  Source  File  -  a  file  containing  the  Instrumented 
source  code. 

3.2  ACAP  CODE  TRANSLATOR 

The  code  translator  Is  entered  via  main  menu  Item  3,  Software 
Assessment. 

3.2.1  Inputs 

The  Code  Translator  accepts  the  following  Inputs: 

a.  Instrumented  Source  File  generated  by  the  Input  Processor. 

b.  PARSER. TBL  -  A  file  containing  a  description  of  the  assembly 
language  being  translated. 
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c.  Control. NML  -  A  file  containing  identification  information  such 
as  File  Name,  Source  Language  Selected,  Date,  Time,  and  Program 
Name. 

3.2.2  Processing 

The  ACAP  Code  Translator  consists  of  the  procedures  shown  in  the 

structure  charts  of  Section  4.  SCANNER  reads  each  line  of  code  from  the 
instrumented  source  file  and  transforms  these  lines  into  a  generic  view  of 
each  statement  which  is  independent  of  the  specific  language  being  processed. 
This  generic  information  consists  of  codes  or  "tokens"  which  describe  each 

statement  including  statement  labels,  label  references,  directives, 
parameters,  and  comments.  The  translation  is  controlled  by  a  file 

(PARSER. TBL)  containing  tabular  Information  about  the  operators  and 

instructions  of  the  source  program's  assembly  language.  This  generic 
Information  Is  accumulated  In  a  file  (TRNSL.FIL)  to  be  evaluated  by  the  Static 
Analysis  module.  This  file  contains  the  necessary  Information  about  each 
procedure  of  the  source  code  for  subsequent  static  analysis.  An  Interface 
diagram  for  the  Code  Translator  Is  shown  In  Figure  3-3  below: 


CONTROL. NML  - 

Instrumented  Source 
File - 


PARSER. TBL ■ 


FIGURE  3-3  -  CODE  TRANSLATOR 
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[  ]  ■  Optional 


3.2.3  Outputs 

The  Code  Translator  generates  the  following  outputs: 


a.  Control  File:  CONTROL. NML  -  Scanner  adds  the  Parser  Table 
(Namelist  PARSER  TABLE  from  file  PARSER. TBL)  to  this  file. 
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b.  Translated  Source  File:  TRNSL.FIL  -  A  file  containing  the 
generic  information  on  the  assembly  language  being  analyzed. 

c.  Abstract  File:  ABSTSQM.NML  -  A  file  containing  data  on  the 
occurrence  of  Instrumented  abstracts. 

d.  Procedure  File:  SCANSQM.NML  -  A  file  containing  the  software 
metrics  accumulated  by  the  SCANNER  for  each  procedure.  See 
Section  5  for  more  Information. 

e.  Error  File:  ERROR. NHL  -  A  file  In  which  errors  are  accumulated 
regarding  this  analysis. 

f.  Debug  File:  INSTRM.FIL  -  An  optional  output  file  which  contains 
debug  Information  on  Instrumented  lines  controlled  by 
INSTRM_PRNT  In  PARSER_TABLE. 

g.  Debug  File:  COMMENT. FIL  ~  An  optional  output  file  which 

contains  debug  Information  on  comments  controlled  by 
COMMENT_PRNT  In  PARSER_TABLE. 

h.  Debug  File:  PARSER. FIL  -  An  optional  output  file  which  contains 

debug  Information  on  the  parser's  output  for  each  line 
controlled  by  PARSERJ>RNT  In  PARSER_TABLE. 

1.  Debug  File:  STRINGS. FIL  -  An  optional  output  file  which 

contains  debug  Information  on  the  strings  found  In  each  line 

controlled  by  STRIN6S_PRNT  In  PARSER_TABLE. 

3.3  ACAP  STATIC  ANALYZER 

The  ACAP  executive  passes  control  to  this  module  when  the  user 
selects  main  menu  Items  3,  Software  Assessment. 
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3.3.1  Inputs 

The  Static  Analyzer  accepts  the  following  inputs: 

a.  Control  File:  CONTROL. NML  -  A  file  used  to  control  how  the 
program  is  analyzed. 

b.  Translated  Source  File:  TRNSL.FIL  -  A  file  generated  by  the 
Code  Translator  containing  the  translated  assembly  language 
source  In  generic  form. 

c.  Abstract  File:  ABSTSQM.NML  -  A  file  containing  data  on  the 
occurrence  of  instrumented  abstracts. 

d.  Procedure  File:  SCANSQM.NML  -  A  file  generated  by  SCANNER 
containing  certain  software  metrics. 

e.  Error  File:  ERROR. NML  -  A  file  In  which  errors  are  accumulated. 

3.3.2  Processing 

The  Static  Analyzer  consists  of  the  procedures  shown  In  structure 
charts  of  Section  4.  These  procedures  utilize  the  TRNSL.FIL  created  by  the 
Code  Translator  to  determine  Information  about  the  software  being  assessed. 
Software  quality  metrics  are  calculated  by  the  Static  Analyzer  as  well  as  path 
and  variable  usage  Information.  The  results  of  this  processing  are  written  to 
various  files  that  are  utilized  as  Input  data  to  the  Report  Writer.  An 
Interface  diagram  for  the  Static  Analyzer  Is  shown  In  Figure  3-4  below: 


CONTROL..NML 
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BRANCH. NML 


TRNSL.FIL  - 
ABSTSQH.NML' 
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MASTER 


FIGURE  3-4  -  STATIC  ANALYZER 


VUR.NML 
ERROR. NML 
MACRO. NML 
[Master  File] 

[  ]  «  Optional 


3.3.3  Outputs 

The  Static  Analyzer  generates  the  following  outputs: 

a.  SQM. NML  -  A  file  containing  the  software  quality  metrics. 

b.  BRANCH. NML  -  A  file  containing  label  and  branching  Information 
used  In  determining  a  programs  structure  and  whether  or  not 
undefined  Interfaces  exist. 

c.  MACRO. NML  -  A  file  containing  MACRO  usage  data. 

d.  VUR.NML  -  A  file  containing  the  variable  usage  data. 

e.  ERROR. ML  -  A  file  containing  any  errors. 

f.  Master  File  -  A  user-specified  file  concatenating  all  of  the 
static  analysis  output  files. 

3.4  ACAP  REPORT  WRITER 

The  ACAP  executive  passes  control  to  this  module  when  the  user 
selects  main  menu  Item  4,  Report  Writer.  In  addition,  the  report  writer  was 
designed  to  be  used  by  encoders  and  code  analysis  programs  other  than  ACAP. 
Use  of  the  Report  Writer  while  outside  ACAP  is  accomplished  by  Issuing  the 
command  "PCAPWRITE".  This  command  places  the  user  directly  Into  the  Report 


Writer's  executive  menu  from  which  report  selection  and  processing  options  $re 
available.  Either  a  single  Master  File  or  Individual  Report  Data  Files  may  be 
utilized  as  input  to  the  Report  Writer.  See  Appendix  A  for  detailed 
descriptions  of  these  files. 

3.4.1  Inputs 

The  Report  Writer  accepts  the  following  inputs: 

a.  CONTROL. NML  -A  file  used  to  control  how  the  program  is  analyzed. 

b.  SQM. NML  -  A  file  containing  the  software  quality  metrics  of  the 
software  being  analyzed. 

c.  BRANCH. NML  -  A  file  containing  the  structure  Information  on  the 
software  being  analyzed. 

d.  VUR.NML  -  A  file  containing  the  variable  usage  information  on 
the  software  being  analyzed. 

e.  MACRO. NML  -  A  file  containing  MACRO  usage  Information  on  the 
software  being  analyzed. 

f.  Master  File  -  A  user-specified  file  which  contains  all  of  the 
static  analysis  output  files  concatenated  Into  a  single  file. 

g.  Instrumented  Source  File  -  The  Instrumented  assembly  language 
source  file. 


3.4.2  Processing 

The  procedures  composing  the  Report  Writer  are  shown  In  the  structure 
charts  of  Section  4.  The  Interface  diagram  for  the  report  writer  Is  shown  In 
Figure  3-5.  These  procedures  read  the  master  file  and  sort  the  data  as 
necessary  to  create  the  output  reports. 


The  Repart  Writer  generates  the  following  outputs: 

a.  Module  Report  (Program_Name.MOD) 

b.  Summary  Report  {Program_Name.CPL) 

c.  Compliance  Report  (Program_Name.CPL) 

d.  Software  Quality  Metrics  Report  (Program_Name.SQM) 

e.  Calls  Report  (Program_Name.CAL) 

f.  Structure  Diagrams  (Program_Name.STR) 

g.  Undefined  Externals  Report  (Program_Name.EXT) 

h.  Variable  Usage  Report  (Program_Name.VUR) 

i.  Sequenced/Paginated  Listing  (Program_Name.LST) 

j.  MACRO  Usage  Report  (Program_Name.MUR) 

Examples  of  these  reports  are  provided  in  Section  6. 
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FIGURE  3-5  -  REPORT  WRITER 
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ACAP  PROGRAM  DESCRIPTION 


The  ACAP  program  is  composed  of  the  modules  and  procedures  as  shown 
in  Figure  4-2.  These  figures  contain  structure  charts  for  the  entire  program 
down  to  the  subroutine  level.  In  general,  these  charts  only  contain 
ACAP-speciflc  procedures  and  not  library  procedures.  A  definition  of  the 
various  structure  chart  constructs  is  shown  in  Figure  4-1. 

The  ACAP  program  is  composed  of  modules  and  procedures  written  in  VAX 
Fortran  and  DCL  (DEC  Command  Language). 

Table  4-1  contains  an  alphabetized  list  of  the  source  files  which 
compose  the  ACAP  system.  The  following  conventions  have  been  used  with 
respect  the  file  name  extensions: 

BAN  -  DCL  file  used  to  display  a  banner  to  the  user  indicating  what 
the  program  Is  doing. 

COM  -  DCL  files. 

FOR  -  Fortran  source  files. 

INC  -  Include  files. 

MEN  -  DCL  files  used  to  display  a  menu. 

MTL  -  Master  template  files. 

NML  -  Namelist  files. 

Table  4-2  shows  which  of  these  files  must  be  linked  together  to  form 
the  various  ACAP  modules. 


_ Filename 

6800. MEN 

68000.MEN 

ACAP.COM 

ACAPBAN.MEN 

ACAPCAP.MEN 

ACAPEXIT.BAN 

ACAPFLOW.MEN 

ACAPLAN.BAN 

ACAPMAIN.MEN 

ASMCHOICE.COM 

ASMCHOICE.MEN 

ASSESS. BAN 

ASSESS.COM 

B INSEARCH. FOR 
BLK2BLK.F0R 
BRANCHES. FOR 

BRSQMNML.INC 

CALLSNML.INC 

CALLSRPT.FOR 

CAPWRITE.COM 


TABLE  4-1 

ACAP  PROGRAM  FILES 


Structure 
Chart  Number 

5.2.2 

5.2.3 
0 

1 

3.3.1 
9 

3.2.1 
8 

2 

5.2 

5.2.1 

5.1 
5 

5.4.6. 1 
5. 4. 2. 4 
5.4.5 


6. 2. 3.1 
6.2 


_ Description _ 

Banner  for  6800  selection. 

Banner  for  68000  selection. 

Com  file  for  running  ACAP. 

Banner  for  ACAP. 

List  of  available  languages. 

ACAP  exit  banner. 

ACAP  flow  diagram. 

Banner  used  in  New  Language. 

ACAP  main  menu. 

Com  file  to  select  Assembly  Language. 

Menu  of  available  languages. 

Menu  of  software  assessment  options. 

Com  file  for  running  software 
assessment. 

Subroutine  BINJSEARCH. 

Subroutine  for  extracting  next  token. 

Main  routine  for  obtaining  branch 
metric  data. 

Include  file  for  BRCHJSQM  namelist  used 
In  the  file  BRSQM.NML~to  communicate 
between  BRANCHES  and  SQMETS. 

Include  file  for  CALLS  Namelist. 

Main  routine  for  generating  CALLS 
report. 

Com  file  for  generating  reports. 
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TABLE 

ACAP 

4-1  (Continued) 

PROGRAM  FILES 

Filename 

Structure 
Chart  Number 

Description 

CNTRLCOM. INC 

- 

Include  file  for  SUMJ1EP  and  SUM_EXEC 
used  to  control  metrics  for  summary 
report. 

CNTRLREP.NML 

- 

Namelist  for  controlling  summary  report 

COMPLY.COM 

6.2. 1.2.2. 1.1.1 

Com  file  to  edit  REPORT. TPL  (or  MTL  If 
non-existent). 

CREPAR.COM 

8 

Com  file  used  in  New  Language. 

CREPAR1.COM 

8 

Com  file  used  in  New  Language. 

CREPATH.FOR 

6. 2. 3. 6. 1.2 

Subroutine  CREATE_PATH. 

CTEXEC.BAN 

5.4.1 

Banner  Indicating  executing  code 
translator. 

CURSORPOS.FOR 

6.2.1. 2.1 

6.2.1. 2.2.1.3.1 

Subroutine  SET_CURSOR_POS. 

DEFPRO.COM 

5.4 

Com  file  for  doing  translation  and 
static  analysis. 

DRAUMENU.FOR 

6.2. 1.1 

6.2.1. 2. 2. 1.2 

Subroutines  DRAW_MENU  and  INVERT_PRINT. 

ERROR. FOR 

4. 4. 2. 2 

Subroutine  PRINT JRROR. 

EXTREP.FOR 

6. 2.3.2 

Main  routine  for  generating  External 
Reference  Report. 

GENDAT.COM 

8 

Com  file  used  In  New  Language. 

GENRPT.BAN 

6.1 

Banner  for  Report  Writer. 

GENRPT.COM 

6 

Com  file  for  Report  Writer. 

GETCHR.FOR 

6.2.1. 3.1 

Function  GETCHR-sIngle  character 
synchronous  read.' 

6IVEHELP.F0R 


6.2. 1.3 
6. 2.1. 2.2. 1.4 


Subroutine  GIVE  HELP  for  writing  help 
flits. 
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TABLE  4-1  (Continued) 


ACAP 

PROGRAM  FILES 

Filename 

Structure 
Chart  Number 

Description 

HALSCOM.INC 

- 

Include  file  used  by  PAR68T.F0R  and 
SCAN68T.F0R  for  passing  HALSTEADS 
information. 

HALSKC.INC 

— 

Include  file  used  by  PARSKC.FOR  and 
SCANSKC.FOR  for  passing  Halsteads 
Information. 

IDNML.INC 

m 

Include  file  for  10  namelist. 

INEDT.BAN 

4.3.1 

4.5.1 

Banner  Indicating  entry  Into  editor. 

INSEXEC.8AN 

4.4.1 

Banner  for  doing  Instrumentation. 

INSTRM.FOR 

4.4.2 

Main  routine  for  doing  Instrumentation. 

INSTRU.BAN 

4.1 

Menu  for  Instrumenting  source  code. 

INSTRU.COM 

4 

Com  file  for  doing  Instrumentation. 

INSTRU1.COM 

4.2 

Com  file  for  selecting  source  file  name. 

INSTRU2.COM 

4.3 

Com  file  for  defining  Instrumentation. 

INSTRU3.COM 

4.4 

Com  file  for  doing  Instrumentation. 

INSTRU4.COM 

4.5 

Com  file  for  editing  Instrumented 
source. 

INTRO.COM 

3 

Com  file  for  ACAP  Introduction. 

INTR01.COM 

3.1 

Com  file  for  ACAP  overview. 

INTR02.COM 

3.2 

Com  file  for  ACAP  flow. 

INTR03.C0M 

3.3 

Com  file  for  language  availability 

Intro. 

10. INC 

- 

Include  file  used  In  PRINRK6. 

IRM.MTL 

Master  template  file  for 

Instrumentation.  Used  by  INSTRU2. 

LENGTH. FOR 

6.2. 3.4.1. 1 

6. 2.3. 7. 3*1 

Function  LENGTH  finds  the  length  of  a 
string. 
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TABLE  4-1  (Continued) 
ACAP  PROGRAM  FILES 


Filename 

Structure 
Chart  Number 

Description 

MAC USE. FOR 

5.4.9 

Complies  MACRO  usage  Information  for 
use  by  MACRPORT.FOR. 

MACRPORT.FOR 

6.2. 3. 9 

Creates  a  MACRO  usage  report. 

MACCOM.INC 

- 

Include  file  used  by  MACUSE.FOR  and 
MACRPORT.FOR. 

MAS.COM 

5.4.7 

Com  file  for  creating  master  file. 

MASTER.COM 

8 

Com  file  used  In  New  Language. 

MENU.NML 

Namelist  file  containing  SMETRIC  MENU 
and  $REP  WRITE  MENU  used  by  REPEIEC 
and  SUMEXEC. 

MENU NML. INC 

- 

Include  file  for  METRIC  MENU  and 
REPWRITEJ1ENU. 

METRICCOM.INC 

- 

Include  file  for  METRICS  namelist  and 
common  used  by  SqMETS. 

METR ICNML.INC 

- 

Include  file  for  METRICS  namelist. 

MFCRE.BAN 

5.4.7. 1 

Banner  Indicating  creating  master  file. 

MODREP.FOR 

6.2.3. 3 

Main  routine  for  generating  Module 
Report. 

NEXTPROC.COM 

6.2.3 

Com  file  for  generating  selected 
reports. 

NMLEXEC.BAN 

4.3.2 

Banner  Indicating  processing 
Instrumentation  namelist. 

NOAVAIL. MEN 

5.2.4 

Banner  Indicating  language  not 
available. 

NORMALIZE. FOR 

5. 4. 2. 3 

Subroutine  for  normalizing  a  source 
line. 

PARI IT. FOR 

5.4.11.7 

Parses  a  line  for  P0P11. 

PAR68T.F0R 

S. 4.8.5 

Subroutine  for  parsing  MS8000  source. 

PARSER. FOR 

$.4.2.5 

Subroutine  for  parsing  5800  source. 
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TABLE  4-1  (Continued) 
ACAP  PROGRAM  FILES 


Structure 

Filename  Chart  Number 


PARSKC.FOR 

5.4.10.5 

P6800.TBL 

- 

PM68000.TBL 

PDP11.MEN 

5.2.6 

PARSERNML. INC 

- 

PARS KCNML. INC 

- 

P6800TBL.MTL 

MV 

PSKCTBL.MTL 

•M 

PAR68TNML.INC 

- 

PM68000TB.MTL 

m 

PATHPKG.FOR 

6. 2. 3. 6.3 

PRINPKG.FOR 

6. 2. 3. 6. 3. 2 

PRINTEXEC.FOR 

7.2 

PRINTEXEC.HLP 

- 

PSKC.TBL 

- 

REPEXEC.FOR 

6.2.1 

REPEXEC.HLP 

«m 

REPORT .MTL 

_ Description _ 

Subroutine  for  parsing  SKC  source. 

Parser  Table  for  6800  source. 

Parser  Table  for  M68000  source. 

Banner  for  POPU  selection. 

Include  file  for  6800  PARSER_TABLE. 

Include  file  for  SKC  PARSER_TABLE. 

Master  template  file  for  6800 
PARSER_TABLE. 

Master  template  file  for  SKC 
PARSER JABLE. 

Include  file  for  PM68000  PARSERJABLE 

Master  template  file  for  M68000 
PARSERJABLE. 

Subroutine  PATH  and  RECURSION. 

Subroutine  PR INREP,  STRUCTURE. 

WRITE  HEADER,  CALCCOLS,  BUILD  LINE, 
CHEClQECURSION,  LASTCALL.  “ 

Main  routine  for  view/print. 

HELP  file  passed  to.  GIVE  HELP  In 
View/Print. 

SKC  PARSERJABLE. 

Main  routine  for  selecting  reports. 

Also  contains  SET_UP_RUN. 

Help  file  passed  to  61 VE  HELP  by 
REPJXEC. 

Master  template  file  for  Compliance  and 
Summary  Reports. 
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TABLE  4-1  (Continued) 
ACAP  PROGRAM  FILES 


Filename 

Structure 
Chart  Number 

Description 

RWEXEC.BAN 

6.2.2 

Banner  Indicating  report  writer 
executing. 

SAEXEC.BAN 

5.4.3 

Banner  indicating  executing  static 
analyzer. 

SCAN11T.FOR 

5.4.11 

Translate  PDP11  code. 

SCAN68T.F0R 

5.4.8 

Main  routine  for  M68000  code  translator 

SCANNER. FOR 

5.4.2 

Main  routine  for  6800  code  translator. 

SCANSKC.FOR 

5.4.10 

Main  routine  for  SKC  code  translator. 

SCNSQMNML. INC 

Include  file  for  SCAN  SQM  (file 
SCANSQM.NML)  and  ABSTRACT  SQM  (file 
ABSTSQM.NML)  namelists  used  to 
communicate  between  code  translator 
and  static  analyzer. 

SELECT. FOR 

6. 2.1. 2. 2. 1.3 

Subroutine  SELECT_METRICS. 

SELFILE.FOR 

5.3.1 

Main  routine  for  selecting  Instrumented 
file. 

SELREP.FOR 

6. 2.1. 2 

Subroutines  SELECT  REPORTS  and 
NEXT_MENU. 

SELREPVP.FOR 

7.2.2 

Subroutine  SELECT_REPORT_VP  used  In 
View/Print  menu  selection. 

SELSRC.COM 

5.3 

Com  file  for  selecting  Instrumented 
source  file. 

SEQLIST.FOR 

6. 2. 3.4 

Main  routine  for  generating  sequential 
listing. 

SKC.MEN 

5.2.5 

Banner  for  SKC  selection. 

SORTCH.FOR 

6.2.3.6.1.1 

Subroutine  SORTCH. 

SONETS. FOR 

5.4.6 

Main  routine  for  compiling  software 
quality  metrics. 

SQMREP.FOR 

6. 2.3. 5 

Main  routine  for  generating  ssoftwere 
Quality  Metrics  Report. 
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TABLE  4-1  (Continued) 
ACAP  PROGRAM  FILES 


Filename 

Structure 
Chart  Number 

Description 

SSORT.FOR 

5.4.5. 1 

Subroutine  SSORT. 

STRINGCOM.INC 

- 

Include  file  for  SCANNER  containing 
string  Info. 

STRUC.INC 

- 

Include  file  used  In  RO  PROC.  PRINREP. 
STRUCTURE,  and  CHECK_RECURSION. 

STRUCTURE. FOR 

6. 2. 3. 6 

Main  routine  for  generating  Structure 

D1 agrams. 

SUMCOM.INC 

- 

Include  file  for  SUM_REP  with  report 
headings. 

SUMEXEC.FOR 

6.2.1. 2.2.1 

Subroutine  SUM_EXEC  to  select  summary 
metrics: 

SUMEXEC.HLP 

- 

Help  file  passed  to  GIVE  HELP  by 
$UM_EXEC. 

SUMREP.FOR 

6. 2. 3. 7 

Main  routine  for  generating  Summary  and 
Compl lance  Reports. 

TONML.FOR 

4. 3. 3.1 

Subroutine  setting  up  Instrumentation 
namelist. 

TRANS.COM 

8 

Main  routine  for  View/Print. 

TRNSLCOM.INC 

- 

Include  file  for  SCANNER  containing 
variable  that  are  written  to 
translation  file. 

TRANSLTPL.FOR 

4.3.3 

Main  routine  for  Instrumentation 
namelist. 

UNIQUE. FOR 

6.2.3.6.1 

Subroutine  UNIQUE. 

UNISORTS. FOR 

6. 2. 3.2.1 

Subroutine  UNISORTS. 

VARUSE.FOR 

5.4.4 

Main  routine  for  compiling  variable 
usage  data. 

VARUSENML. INC 

- 

Include  file  for  VARUSE.NML  part  of 
master  file. 

VIEWPRINT.BAN 

7.1 

Banner  for  View/Print. 

VIEWPR.COM 

7 

Com  file  for  View/Print. 
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TABLE  4-1  (Continued) 
ACAP  PROGRAM  FILES 


Structure 

Filename  Chart  Number  _ Description _ 

VUREPORT.FOR  6.2. 3.8  Main  routine  for  generating  Variable 

Usage  Report. 

VUSQMIWL. INC  -  Include  file  for  VU_SQM  namelist  used  In 

the  file  VUSQM.NML  to  communicate 
between  VARUSE  and  SONETS. 


Program 

BRANCHES 

CALLSRPT 

EXTREP 

INSTRM 

MODREP 

MACUSE 

MACRPORT 

REPEXEC 

PRINTEXEC 

SCANNER 

SCAN68T 

SCANSKC 

SELFILE 

SEQLIST 

SqHETS 

SQMREP 

SUMREP 

TRANSLTPL 

VARUSE 

VUREPORT 

STRUCTURE 

SCANUT 


TABLE  4-2 

LINK  SEQUENCE  FOR  ACAP  PROGRAMS 

_ Link  Sequence _ 

BRANCHES,  SSORT,  B INSEARCH 
CALLSRPT 

EXTREP,  UNISORTS,  LENGTH 
INSTRM,  LENGTH,  ERROR 
MOOREP 

MACUSE,  SSORT 
MACRPORT 

REPEXEC,  SELREP,  CURSORPOS,  SUMEXEC,  DRAWMENU,  SELECT, 
GIVEHELP,  GETCHR,  LENGTH,  ERROR 

PRINTEXEC,  SELREPVP  CURSORPOS,  ORAHMENU,  GIVEHELP, 

GETCHR,  LENGTH 

SCANNER,  NORMALIZE,  BLK2BLK,  PARSER,  SSORT 
SCAN68T,  NORMALIZE,  BLK2BLK,  PAR68T,  SSORT 
SCANSKC,  NORMALIZE,  BLK2BLK,  PARSKC,  SSORT 
SELFILE 

SEQLIST,  LENGTH,  NORMALIZE 
SQMETS,  B INSEARCH 
SqMREP 

SUMREP,  LENGTH 
TRANSLTPL,  TONML,  LENGTH 
VARUSE,  SSORT 
VUREPORT 

STRUCTURE,  UNIQUE,  SORTCH,  CREPATH,  PATHPK6,  PRINPKG,  LENGTH 
SCANUT,  PARUT,  NORMALIZE,  SSORT 
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FIGURE  4-1 

STRUCTURE  CHART  CONSTRUCTS 
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FIGURE  4-2 

ACAP  STRUCTURE  CHARTS 


NOTE:  The  name  shown  In  the  boxes  is  the  actual  Fortran  name  by  which  the 

procedure  is  referenced.  If  the  procedure  Is  part  of  a  larger  fortran  file  a 
note  is  made  referencing  the  file  name. 
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5.0 


ACAP  DATA  FILE  DESCRIPTION 


This  section  lists  all  the  data  files  that  are  used  by  the  ACAP 
system  for  communication  between  modules.  Temporary  files  are  not  listed. 
The  table  gives  the  file  name,  where  the  file  is  used;  where  the  file  is 
created,  and  provides  a  brief  description.  Detailed  formats  for  specific 
files  associated  with  the  Master  File  are  presented  in  Appendix  A. 


(Note:  SCANNER  is  used  here  in  the  generic  sense  and  stands  for 

either  SCANNER. FOR,  SCAN68T.F0R  or  SCANSKC.FOR.) 

ACAP  Files  With  Fixed  File  Names 


File 

Used 

Created 

Description 

ABSTSQM.NML 

SQMETS 

SCANNER 

Information  on  instrumented 
abstracts  -  number  of  lines 
and  number  of  lines  skipped. 

BRANCH. NHL 

MAS 

BRANCHES 

Branch  data  for  each 
procedure.  Put  Into  master 
file. 

8RCHSQM.NML 

SQMETS 

BRANCHES 

Information  on  branches  - 
number  of  forward,  backward, 
out,  conditional,  and 
unconditional  branches;  number 
of  nodes  and  paths. 

COMMENT. FIL 

SCANNER 

Optional  debug  data  on 
comments  controlled  by 
COMMENT_PRNT  In  PARSERJABLE. 

CONTROL. NML 

MAS 

SCANNER 

Data  used  to  control 
analysis.  Includes 

PARSER  TABLE.  Put  Into  master 
file.  “ 

ERROR. NML 

MAS 

SCANNER 

SQMETS 

BRANCHES 

VARUSE 

Errors  accumulated  during 
analysis  run.  Put  Into  master 
file. 

INSTRM.FIL 

SCANNER 

Optional  debug  data  on 
Instrumented  lines  controlled 
by  INSTRM  PRNT  In 

PARSER  TABLE. 
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e 


Created 


Description 


File  Used  Created  Description 

IRM.NML 

INSTRH 

INSTRU2 

Instrumentation  file 
containing  the  instrumentation 
value  and  code  constructs 
where  value  is  to  be  inserted. 
Created  from  IRM.MTL  if 

IRM.TPL  does  not  exist. 

MACROS. NML 

MACRPORT 

MACUSE 

MACRO  definition  and  usage 
information. 

PARSER. TBL 

SCANNER 

Parser  table  containing  a 
description  of  assembly 
language  being  analyzed. 

PARSER. FIL 

SCANNER 

Optional  debug  data  on  parser 
performance  controlled  by 
PARSER_PRNT  in  PARSER_TABLE. 

SCANSQM.NML 

SQMETS 

BRANCHES 

SCANNER 

Software  metrics  accumulated 
by  SCANNER  for  each  procedure 
-  dealing  with  Instrumentation 
such  as  module  name  and 

sequence,  procedure  name  and 
sequence,  number  of  lines 
skipped,  number  of  unique 
operators,  number  of  operators 
used,  number  of  unique 
operands,  number  of  operands 
used,  and  the  line  number  In 
the  instrumented  source  on 
which  the  procedure  starts. 


SQM. NML 

MAS 

SQMETS 

Data  on  software  quality 
metrics.  Put  Into  master 
file. 

STRINGS. FIL 

SCANNER 

Optional  debug  data  on 
strings  found  In  each  line. 
Controlled  by  STRINGS  PRNT  In 
PARSER_TA8LE. 

TRNSL.FIL 

SQMETS 

VARUSE 

BRANCHES 

SCANNER 

Translated  assembly  language 
code  In  generic  form. 

VUR.NML 

MAS 

VARUSE 

Data  on  variable  usage.  Put 
Into  master  file. , 
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K'V  'V  v*v 


ACAP 

Files  User-Defined 

File  Names 

File 

Used 

Created 

Description 

VUSQM.NML 

SQMETS 

VARUSE 

Data  on  number  of  variables 
in  a  procedure. 

Instrumented 
Source  File 

SCANNER 

SEQLIST 

INSTRM 

Assembly  language  source  file 
instrumented  so  It  Is  ready 
for  analysis. 

Master  File 

CALLSRPT 

EXTREP 

MACRPORT 

MODREP 

PRINTEXEC 

REPEXEC 

SEQLIST 

SQMREP 

STRUCTURE 

SUMREP 

VUREPORT 

MAS 

Concatenation  of  VUR.NML, 
BRANCHES. NML,  SQM.NML, 

MACRO. NMl,  CONTROL. NML, 

ERROR. NML.  (See  Appendix  A.) 

Program  Name.CAL 

CALLSRPT 

Calls  Report 

.CPL 

SUMREP 

Compliance  and  Summary  Reports 

.EXT 

EXTREP 

Undefined  Externals  Reports 

.MOO 

MODREP 

Module  Report 

.SQM 

SQMREP 

Software  Quality  Metrics 

Report 

Structure  Diagrams 

.STR 

STRUCTURE 

•  VUR 

VUREP 

Variable  Usage  Report 

.MUR 

MACRPORT 

MACRO  Usage  Report 

Source  File  INSTRM 
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6.0 


SAMPLE  REPQKTS 


The  various  reports  available  from  ACAP  are  displayed  in  this 
section.  These  reports  are  obtained  by  using  the  generalized  report  writer 
described  In  Section  2.4. 
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:d  software  listing 


SEQUENCED  SOFTWARE  LISTING 


SEQUENCED  SOFTWARE  LISTING 


:eo  software  listing 


CAP  SEQUENCED  SOFTWARE  LISTING 


UNCLASSIFIED 


Module  name 


CAP  MODULE  REPORT 
Program:  FNLTEST 

!  Procedure  name 


MODI  SIXTEENCHAR 


3  Procedure(s) 


INST_PRCC_SIXTEN 

CINST 

DINST 


M0D2 


3  Procedure(s) 


JINST 

MINST 

NINSTS 


M0D3 


2  Procedure(s) 


SINSTS 

TINSTS 


M0D4 


2  Procedure(s) 


!  MACTESTS 
i  CONDTEST 


AD-A165  029  METHODOLOGY  INVESTIGATION  PROGRAM  FLOH  ANALY2ER  VOLUME  2/2 
2<U>  ARNV  ELECTRONIC  PROVING  GROUND  FORT  HUACHUCA  AZ 
E  L  ANDERSON  SEP  85 

UNCLASSIFIED  F/G  9/2  NL 


END 


BIFIED  PAUE 


UNCLASSIFIED 


PAGE 
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FNLTEST  SOFTWARE  QUALITY  METRICS  REPORT 


! 

I 


COOE  ANALYSIS  REPORT  FOR  MODULE:  MOD  1  __S  I X TEENCHAR 
CODE  ANALYSIS  REPORT  FOR  PROCEDURE:  INST_PROC. S I XTEN 


LINES  IN  THE  ABSTRACT 

= 

3 

COMMENT  ONLY  LINES 

s 

0 

EXECUTABLE  LINES 

* 

31 

NON-EXECUTABLE  LINES 

s 

.  --N 

LINES  SKIPPED 

= 

0 

COMMENTS  FOR  EXECUTABLE  LINES 

* 

N/A 

COMMENTS  FOR  NON-EXECUTABLE  LINES 

» 

N/A 

COMMENTS  ON  A  LINE  OF  CODE 

= 

5 

PERCENT  OF  EXECUTABLE  LINES  COMMENTED 

*  N/A 

PERCENT  OF  NON-EXECUTABLE  LINES  COMMENTED 

*  N/A 

MAXIMUM  CONSECUTIVE  LINES  WITHOUT  A  COMMENT 

* 

37 

EXECUTABLE  STATEMENTS 

= 

31 

NON-EXECUTABLE  STATEMENTS 

* 

22 

MULTI-LINE  STATEMENTS 

ac 

N/A 

MULT I -STATEMENT  LINES 

m 

N/A 

LINES  OF  CODE  (PRIMARY  LANGUAGE) 

m 

31 

LINES  OF  CODE  (EMBEDDED  LANGUAGE) 

m 

N/A 

PRIMARY  VS.  EMBEDDED  LANGUAGE  SWITCHES 

m 

N/A 

NUMBER  OF  VARIABLES 

m 

23 

TOTAL  LINES 

m 

36 

ENTRY  POINTS 

m 

4 

EXIT  POINTS 

m 

1 

INCLUDE  STATEMENTS 

m 

2 

FORWARD  BRANCHES 

m 

2 

BACKWARD  BRANCHES 

m 

1 

BRANCHES  OUT  t)F  THE  ROUTINE 

m 

0 

CONDITIONAL  BRANCHES 

m 

2 

UNCONDITIONAL  BRANCHES 

m 

1 

METRICS  REPORT  FOR  PROCEDURE:  INST_PROC_SIXTEN 


NODES 

m 

8  i 

PATHS 

m 

9  ) 

MCCABE* S  CYCLOMAT I C 

* 

3  : 

HALSTEAD* S  ANALYSIS  : 


UNIQUE  OPERATORS 

m 

23  i 

UNIQUE  OPERANDS 

m 

31  : 

TOTAL  OPERATOR  USAGE 

m 

87  < 

TOTAL  OPERAND  USAGE 

m 

48  t 

PROGRAM  LENGTH 

m 

133  S 

PROGRAM  VOLUME 

m 

774.910  l 

PROGRAM  LEVEL 

m 

0.034  : 

POTENTIAL  VOLUME 

m 

43.431  t 

DIFFICULTY 

m 

17.804  1 

EFFORT 

m 

13834.008 

UNCLASSIFIED 
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UNCLASSIFIED 


PAGE: 


FNLTEST  SOFTWARE  QUALITY  METRICS  REPORT 


CODE  ANALYSIS  REPORT  FOR  MODULE:  MOD I _S I X TEENCHAR 
CODE  ANALYSIS  REPORT  FOR  PROCEDURE:  CINST 


LINES  IN  THE  ABSTRACT 
COMMENT  ONLY  LINES 
EXECUTABLE  LINES 
NON— EXECUTABLE  LINES 
LINES  SKIPPED 

COMMENTS  FOR  EXECUTABLE  LINES 
COMMENTS  FOR  NON-EXECUTABLE  LINES 
COMMENTS  ON  A  LINE  OF  CODE 

PERCENT  OF  EXECUTABLE  LINES  COMMENTED 
PERCENT  OF  NON-EXECUTABLE  LINES  COMMENTED 
MAXIMUM  CONSECUTIVE  LINES  WITHOUT  A  COMMENT 
EXECUTABLE  STATEMENTS 
NON-EXECUTABLE  STATEMENTS 
MULTI -LINE  STATEMENTS 
MULTI-STATEMENT  LINES 
LINES  OF  CODE  (PRIMARY  LANGUAGE) 

LINES  OF  CODE  (EMBEDDED  LANGUAGE) 

PRIMARY  VS.  EMBEDDED  LANGUAGE  SWITCHES 
NUMBER  OF  VARIABLES 
TOTAL  LINES 


O 

o 

9 

O 

0 


N/A 

N/A 


N/A 

N/A 


ENTRY  POINTS 
EXIT  POINTS 
INCLUDE  STATEMENTS 


FORWARD  BRANCHES 
BACKWARD  BRANCHES 
BRANCHES  OUT7 OF  THE  ROUTINE 
CONDITIONAL  BRANCHES 
UNCONDITIONAL  BRANCHES 


6 

9 

O 


N/A 

N/A 

N/A 

N/A 


3 

9 

1 

1 

0 


O 

o 

1 

1 

o 


METRICS  REPORT  FOR  PROCEDURE:  CINST 


NODES 

PATHS 

MCCABE'S  CYCLOMAT I C 


3 

3 

2 


HALSTEAD'S  ANALYSIS 


UNIQUE  OPERATORS 
UNIQUE  OPERANDS 
TOTAL  OPERATOR  USAGE 
TOTAL  OPERAND  USAGE 

PROGRAM  LENGTH 
PROGRAM  VOLUME 
PROGRAM  LEVEL 
POTENTIAL  VOLUME 
DIFFICULTY 
EFFORT 


12 

12 

30 

14 


201.73S 

0.143 

28.820 

7.000 

1412.108 


UNCLASSIFIED 


•  FNLTEST  SOFTWARE  QUALITY  METRICS 

l 

KSSSS3M8; 

REPORT 

i  CODE  ANALYSIS  REPORT  FOR  MODULE:  MOD 1 _S I X TEENCHAR 

!  CODE  ANALYSIS  REPORT  FOR  PROCEDURE:  DINST 

* 

!  LINES  IN  THE  ABSTRACT 

3 

0 

COMMENT  ONLY  LINES 

= 

0 

i  EXECUTABLE  LINES 

* 

10 

NON-EXECUTABLE  LINES 

* 

l 

:  LINES  SKIPPED 

= 

0 

COMMENTS  FOR  EXECUTABLE  LINES 

* 

N/A 

COMMENTS  FOR  NON-EXECUTABLE  LINES 

= 

N/A 

COMMENTS  ON  A  LINE  OF  CODE 

3 

2 

!  PERCENT  OF  EXECUTABLE  LINES  COMMENTED 

» 

N/A 

!  PERCENT  OF  NON-EXECUTABLE  LINES  COMMENTED 

» 

N/A 

!  MAXIMUM  CONSECUTIVE  LINES  WITHOUT  A  COMMENT 

= 

5 

EXECUTABLE  STATEMENTS 

a 

10 

NON-EXECUTABLE  STATEMENTS 

m 

1 

»  MULT I -LINE  STATEMENTS 

a 

N/A 

S  MULT I -STATEMENT  LINES 

a 

N/A 

LINES  OF  CODE  (PRIMARY  LANGUAGE) 

a 

10 

LINES  OF  CODE  (EMBEDDED  LANGUAGE) 

a 

N/A 

PRIMARY  VS.  EMBEDDED  LANGUAGE  SWITCHES 

a 

N/A 

!  NUMBER  OF  VARIABLES 

m 

1 

TOTAL  LINES 

m 

11 

ENTRY  POINTS 

m 

2 

: 

EXIT  POINTS 

a 

1 

: 

INCLUDE  STATEMENTS 

m 

0 

FORWARD  BRANCHES 

m 

0 

• 

• 

BACKWARD  BRANCHES 

BRANCHE8  OUT  OF  THE  ROUTINE 

m 

m 

i 

1 

i 

t 

CONDITIONAL  BRANCHES 

m 

2 

i 

• 

UNCONDITIONAL  BRANCHES 

m 

0 

t 

• 

METRICS  REPORT  FOR  PROCEDURE:  DINST 


i - 

t 

i 

• 

• 

• 

• 

NODES 

PATHS 

MCCABE'S  CYCLOMAT I C 

- 

5 

6 

3 

1 

: 

i 

HALSTEAD'S  ANALYSIS  :  ! 

f 

• 

UNIQUE  OPERATORS 

m 

13 

» 

• 

1 

UNIQUE  OPERANDS 

m 

12 

• 

• 

l 

TOTAL  OPERATOR  USAGE 

m 

30 

\ 

9 

TOTAL  OPERAND  USAGE 

m 

17 

i 

| 

J 

PROGRAM  LENGTH 

m 

47 

i 

: 

PROGRAM  VOLUME 

m 

218.261 

t 

: 

PROGRAM  LEVEL 

u 

0.10* 

I 

i 

POTENTIAL  VOLUME 

m 

23.703 

1 

DIFFICULTY 

m 

9.208 

i 

EFFORT 

m 

2009.822 

i 

UNCLASSIFIED 

SIR- 


UNCLASSIFIED 
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FNLTEST  SOFTWARE  QUALITY  METRICS  REPORT 


GLOBAL  CODE  ANALYSIS  REPORT  FOR  MODULE:  MOD 1 _S I X TEENCHAR 


LINES  IN  THE  ABSTRACT 
COMfENT  ONLY  LINES 
EXECUTABLE  LINES 
NON-EXECUTABLE  LINES 
LINES  SKIPPED 

COMMENTS  FOR  EXECUTABLE  LINES 
COMMENTS  FOR  NON-EXECUTABLE  LINES 
COMMENTS  ON  A  LINE  OF  CODE 

PERCENT  OF  EXECUTABLE  LINES  COMMENTED 
PERCENT  OF  NON-EXECUTABLE  LINES  COMMENTED 
MAXIMUM  CONSECUTIVE  LINES  WITHOUT  A  COMMENT 
EXECUTABLE  STATEMENTS 
NON-EXECUTABLE  STATEMENTS 
MULTI-LINE  STATEMENTS 
MULT I -STATEMENT  LINES 
LINES  OF  CODE  (PRIMARY  LANGUAGE) 

LINES  OF  CODE  (EMBEDDED  LANGUAGE) 

PRIMARY  VS.  EMBEDDED  LANGUAGE  SWITCHES 
NUMBER  OF  VARIABLES 
TOTAL  LINES 


3 

0 

50 

23 

O 

N/A 

N/A 

8 

*  N/A 

*  N/A 
37 

50 

23 

N/A 

N/A 

50 

N/A 

N/A 

27 

76 


ENTRY  POINTS  -  7 
EXIT  POINTS  -  3 
INCLUDE  STATEMENTS  »  2 


FORWARD  BRANCHES  *  2 
BACKWARD  BRANCHES  -  2 
BRANCHES  OUT  OF  THE  ROUTINE  -  2 
CONDITIONAL 'BRANCHES  -  5 
UNCONDITIONAL  BRANCHES  «  1 


METRICS  REPORT  FOR  PROCEDURE:  GLOBAL 


NODES 

PATHS 

MCCABE* S  CYCLOMAT IC 


HALSTEAD* 3  ANALYSIS  IS  NOT  APPLICABLE! 


J 

1 


UNCLASSIFIED 

-SIS- 


UNCLASSIFIED 


PAGE 


1 

» 

C  A  P 

CALLS  REPORT 

****** 

Progr am: 

FNLTEST 

•  Procedure  name 

1 

• 

l 

Pr ocedure  called 

•  t 

!  INST_PROC_SI XTEN 
• 

i 

l 

2  Procedure(s) 

cal  led 

* 

< 

:  :  subone 

S  1  CINST 

•  l 

1  i 

:  CINST 

1 

• 

1  Procedure (s) 

cal led 

:  :  dinst 

:  : 

*  _ 

:  DINST 

l 

1 

1  Procedure!*) 

cal led 

1 

• 

1 

1 

1 

■ 

t 

JINST 

:  JINST 

• 

■ 

2  Procedure!*) 

cal led 

SUBTWO 

:  MINST 

'  ! 

MINST 

? 

I  ProcedureCe) 

called 

•  / 

J 

• 

• 

NINSTS 

1  NINSTS 

■ 

• 

0  Procedure (•) 

called 

•  • 

•  • 

•  . 

SXNSTS 

1 

1  Procedure(e) 

called 

• 

• 

• 

• 

TINSTS 

TIN8TS 

1 

0  Procedure!*) 

called 

! 

:  : 

1  MACTESTS 

• 

• 

0  Procedure!*) 

called 

1 

J 


UNCLASSIFIED 
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UNCLASSIFIED 


PAGE 


1 


UNDEFINED  EXTERNALS  REPORT 
SUBROUTINE  CALLS 


SUBONE 

SUBTWO 


UNCLASSIFIED 
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APPENDIX  A 

MASTER  FILE  DESCRIPTION 


The  master  file  contains  a  concatenation  of  all  of  the  principle 
files  resulting  from  the  ACAP  static  analysis.  This  file  has  a  user-specified 
file  name  and  Is  In  namelist  format.  For  more  information  on 
namelist-directed  I/O,  see  the  VAX-11  Fortran  Language  Reference  Manual. 

A.l  NAMELIST  -  DIRECTED  I/O 

As  specified  In  the  VAX-11  Fortran  Reference  Manual,  each  namelist 
data  block  has  the  form: 

$group-name  entity  *  value  [, entity  *  value,... ]$[END] 


where: 


$  Is  the  special  symbol  used  to  Indicate  the  beginning  or  end  of 
Input.  The  ampersand  (A)  can  be  used  In  place  of  the  dollar  sign.  . 

group-name  Is  the  name  of  the  namelist  that  contains  the  entity  or 
entitles  to  be  given  values.  The  namelist  must  have  been  previously 
defined  In  a  NAMELIST  statement  In  the  program  unit. 

entity  Is  a  namelist-defined: 

•  Variable 

e  Array  Name 

•  Subscripted  Variable 

•  Variable  With  a  Substring 

•  Subscripted  Variable  With  a  Substring 

value  Is  a  constant,  a  list  of  constants,  a  repetition  of  constants 
In  the  form  r*c,  or  a  repetition  of  values  In  the  form  r*  value. 

END  Is  an  optional  part  of  the  last  delimiter. 
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A. 2  MASTER  FILE  FORMAT 

The  five  files  from  which  the  master  file  Is  constructed  are: 

VUR.MIL  -  The  file  containing  the  data  on  variable  usage. 

BRANCHES. NML  ~  The  file  containing  the  data  on  branches. 

SQM. NHL  -  The  file  containing  the  data  on  software  quality 
metrics. 

MACRO. NML  -  The  file  containing  the  data  on  MACROS. 

CONTROL. NML  -  The  ACAP  control  file. 

ERROR. NML  -  The  file  containing  the  errors  accumulated  during  the 

ACAP  run. 

At  the  beginning  of  each  of  these  files  Is  the  data  block  for  the 
namelist  group-name  "ID".  This  data  Is  followed  by  the  data  for  the  other 
namelist  group-names  In  that  file.  Each  of  these  files  contains  a  variable 
number  of  namelist  data  blocks  dependent  on  the  source  code  being  analyzed  and 
the  user  options  selected. 

The  format  of  the  master  file  can  be  summarized  as  follows: 

File  Name  Group-Name  _ Number 

VUR.NML  ID  There  Is  one  per  VUR.NML  file. 

VAR  LISTS  There  Is  one  VAR  LISTS  for  each  module 

followed  by  all  The  VARUSAGE  groups  for  that 
module. 

VARUSAGE  There  Is  one  VARUSAGE  group  for  each  procedure 
plus  one  for  the  global  variables  In  the 
module.  The  "global"  VARUSAGE  Is  flagged  by 
PROC  SEQ  ■  0  and  must  precede  the  "procedure" 
VARUTAGE  groups. 


File  Name 

Group-Name 

Number 

BRANCHES. NHL 

ID 

PROC_LISTS 

CALLS 

There  is  one  per  BRANCHES. NML  file. 

There  is  one  PROC  LISTS  for  each  module 
followed  by  all  tFe  CALLS  groups  for  that 
module. 

One  per  procedure. 

SQM. NHL 

ID 

METRICS 

There  Is  one  per  SQM. NML  file. 

There  is  one  METRICS  group  for  each  procedure 
in  a  module  plus  one  for  the  entire  module. 

The  METRICS  group  for  the  entire  module 
follows  the  others  and  Is  flagged  by  PROC  NAME 
-  'GLOBAL*  and  PR0C__SEQ  -  0. 

MACRO. NML 

MACS 

One  per  MACRO  occurrence. 

CONTROL.  NML 

ID 

PARSER_TABLE 

1  per  CONTROL. NML  file. 

1  per  CONTROL. NML  file. 

ERROR. NML 

ID 

SCANNER  ERR 
ID 

BRANCHES  ERR 
ID 

VARUSE  ERR 

ID 

SQMETS  ERR 

1  per  Group-Name 

1  per  error  from  SCANNER. 

1  per  Group-Name 

1  per  error  from  BRANCHES, 

1  per  Group-Name 

1  per  error  from  VARUSE. 

1  per  Group-Name 

1  per  error  from  SQMETS; 

A. 3  NAMELIST  GROUP  DESCRIPTIONS 

The  entitles  within  each  of  these  namelist  group-names  are  described 
In  the  following  table.  There  Is  a  type  specified  for  each  entity  which  takes 
the  form: 

TYPE  N 

where: 

TYPE  Is  either  Char  for  CHARACTER  data;  Int  for  INTEGER  data 
N  Is  the  number  of  bytes. 

The  Dimensions  column  gives  the  size  of  the  array  dimensions  If  the  variable 
Is  an  array. 


TABLE  -  NAMELIST  DESCRIPTIONS 


Entity _  Type  (Dimensions)  _ Description 


n> 

PROGRAM_NAME 

Char  15 

The  name  of  the  program. 

SOURCE_FILE 

Char  15 

Source  file  being  analyzed. 

SOURCE _F  ILE_CLASS 

Char  1 

Classification  of  source  file: 

U  *  Unclassified 

C  *  Confidential 

S  ■  Secret 

T  •  Top  Secret 

Any  Other  Character  ■  ERROR 

SOURCE_LANGUAGE 

Char  15 

Source  language  selected. 

DATE_TRNSL 

Char  10 

Date  translation  of  source 
occurred. 

TIME_TRNSL 

Char  10 

Time  translation  of  source 
occurred. 

FILE_NAME 

Char  15 

'SQM.NML* ,  'VUR.NML', 

BRANCHES. NHL' ,  or  'CONTROL, NHL' 
or  for  ERROR. NHL  file,  **Proc 
Name**  where  Proc  Name  Is 
SCANNER,  VARUSE,  BRANCHES,  OR 
SQMETS. 

VAR  LISTS 

There  1$  one  VAR  LISTS  for  each 
module  followed  Fy  all  the 
VARUSAGE  groups  for  that  module 

MOD_NAME 

Char  31 

Module  name. 

N_PROCS 

Int  4 

Number  of  procedures  In  module 
(Max  »  400). 

PROC_KEY 

Int  4 

(400) 

Variable  flag  for  each 
procedure:  0  ■  Contains  no 
variables.  Else  *  Number  of 
variables. 

PROCJLIST 

Char  31 

(400) 

Names  of  procedures. 

VARJ.IST 

Char  31 

(3000) 

Names  of  variables. 

TABLE  -  NAMELIST  DESCRIPTIONS  (Continued) 


Entity 

VARUSAGE 


Type  (Dimensions) 


"Global “  VARUSAGE 


PROCJSEQ 


L  VARS 


VAR  USAGE 


Int  4 


Int  4 


Int  4  (6,3000) 


VAR  TYPE 


VAR  ACCESS 


Char  3  (3000) 


Int  4  (3000) 


'Procedure*  VARUSAGE 


Description 


There  is  one  VARUSAGE  group  for 
each  procedure  plus  one  for  the 
global  variables  in  the  module. 
The  "global*  VARUSAGE  is  flagged 
by  PROCJSEQ  *  0  and  must  precede 
the  "procedure"  VARUSAGE  groups. 

The  format  for  the  "global" 
VARUSAGE  group  is  as  follows: 

Procedure  sequence  number  In 
module.  0  for  "Global". 

Number  of  entries  in  VARJJSAGE. 
There  Is  an  entry  for  the  usage 
of  each  global  variable  In  each 
procedure  In  which  It  appears. 

Variable  usage  for  each 
procedure,  N  *  1  to  L_VARS. 

(l.N)  Index  to  the  global 
variable  name  In  VAR  LIST. 

(2,N)  Number  of  times  modified. 
(3,N)  Number  of  times 
referenced. 

(4,N)  Number  of  time  tested. 
(5,N)  Number  of  times  variable  Is 
used  as  an  argument. 

(6,N)  Number  of  times  defined. 

User  defined  variable  type 
printed  on  Variable  Usage  Report. 


Index  to  procedure  name  in 
PR0C  LIST  (contained  In  PR0CJ.IST 
group).  The  global  variable'" 
named  in  VAR  USAGE  (l.N)  above 
appears  In  tffii  procedure  named  by 
VAR_ACCESS  (N)  with  the  variable 
usage  as  specified  In  VARJUSAGE. 

The  format  for  the  "procedure" 
VARUSAGE  group  Is  as  follows: 


PROC  SEQ 


Int  4 


Procedure  sequence  number  In 
module. 


TABLE  -  NAMELIST  DESCRIPTIONS  (Continued) 


Entity 

Type 

(Dimensions) 

Description 

L_VARS 

Int  4 

Number  of  variables  In  this 
procedure. 

VARJJSAGE 

Int  4 

(6,3000) 

Variable  usage  for  this 
procedure,  N  ■  1  to  L_VARS. 

( 1 ,N)  Index  to  the  variable  name 
In  VAR_LIST. 

(2,N)  Number  of  times  modified. 
(3,N)  Number  of  times 
referenced. 

(4,N)  Number  of  time  tested. 
(5,N)  Number  of  times  variable  Is 
used  as  an  argument. 

(6,N)  Number  of  times  defined. 

VAR_TYPE 

Char  3 

(3000) 

User  defined  variable  type 
printed  on  Variable  Usage  Report. 

VAR_ACCESS 

Int  4 

(3000) 

Data  access  Information. 

0  -  Local  Variable 

1  -  Global  Variable 

2  -  Argument 

PROC  LISTS 

There  Is  one  PROC_LISTS  for  each 
module  followed  by  all  the  CALLS 
groups  for  that  module. 

MOD_NAME 

Char  31 

Module  name. 

N_PROC 

Int  4 

Number  of  procedures  In  module 
(Max  »  400). 

PROCJ.IST 

Char  31 

(400) 

Names  of  procedures. 

PROCJ.INE 

Int  4 

(3000) 

Line  number  of  procedure. 

N_ENTR  Y_PO I NTS 

Int  4 

Number  of  entry  points. 

ENTR  Y_PO I HT_L I ST 

Char  31 

(3000) 

Names  of  the  entry  points. 

CALLS 

One  per  procedure. 

PROCJSEQ 

Int  4 

Sequence  number  in  module. 

NUHCALLS 

Int  4 

Number  of  procedure  calls. 

PROCjCALLS 

Char  31 

(400) 

Procedure  names. 

TABLE  -  NAMELIST  DESCRIPTIONS  (Continued) 


Entity 

Type 

(Dimensions) 

Description 

PROC_CALLS__LN 

Int  4 

(400) 

The  line  number  from  which  the 
call  was  made. 

METRICS 

There  Is  one  METRICS  group  for 
each  procedure  In  a  module  plus 
one  for  the  entire  modoule.  The 
METRICS  group  for  the  entire 
module  follows  the  others  and  Is 
flagged  by  PROC  NAME  -  'GLOBAL1 
and  PROCJSEQ  *  O’. 

MOD_NAME 

Char  31 

Name  of  module. 

MOO_SEQ 

Int  4 

Sequence  number  of  module. 

PROC_NAME 

Char  31 

Name  of  procedure. 

PROCJSEQ 

Int  4 

Sequence  number  of  procedure. 

N_ABSTRACT 

Int  4 

Number  of  lines  In  the  abstract. 

N_COMMENTJL  I NES 

Int  4 

Number  of  comment  only  lines. 

N_LIHES_X 

Int  4 

Number  of  lines  where  an 
executable  Is  the  first 
Instruction  on  the  line. 

NJLINESJIX 

Int  4 

Number  of  lines  where 
non-executable  Is  the  first 
Instruction  on  the  line. 

N_LINES 

Int  4 

Total  number  of  lines. 

N_COMMENTS_X 

Int  4 

Number  of  comments  In 
executable  statements. 

H_COMMENTS_NX 

Int  4 

Number  of  comments  In 
non-executable  statements. 

N_I  NL I NE  JSOMMENTS 

Int  4 

Number  of  lines  of  code  which 
contain  a  comment. 

N_PER_COMM_X 

Int  4 

Percent  of  executable  lines 
commented. 

N_P£R_COMM_NX 

Int  4 

Percent  of  non-executable  lines 
commented. 
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TABLE  - 

NAMELIST  DESCRIPTIONS  (Continued) 

Entity 

Type 

(Dimensions)  Description 

MAX_WO_COMMENTS 

Int  4 

Maximum  number  of  consecutive 
lines  without  comments. 

N_STAMNTS_X 

Int  4 

Number  of  executable  statements. 

N_STAMNTS_NX 

Int  4 

Number  of  non-executable 
statements. 

HULT _L  I NE_ST AMNT S 

Int  4 

Number  of  compound  lines. 

MULT_STAMNT_LINES 

Int  4 

Number  of  multi  statement  lines. 

N_ENTRY_PTS 

Int  4 

Number  of  entry  points. 

N_EXIT_PTS 

Int  4 

Number  of  exit  points. 

N_BRANCH_FRWO 

Int  4 

Number  of  forward  branches. 

N_BRANCH_BACK 

Int  4 

Number  of  backward  branches. 

N_BRANCH_OUT 

Int  4 

Number  of  branches  out  of  the 
routine. 

N_BRANCH_COND 

Int  4 

Number  of  conditional  branches. 

N_BRANCH_UNCONO 

Int  4 

Number  of  unconditional  branches. 

N_NOOES 

Int  4 

Number  of  nodes.  0  If  no 
executable  statements. 

N_PATHS 

Int  4 

Number  of  paths,  0  If  no 
executable  statements. 

MCCABE SjCYCLOMAT I C 

Int  4 

McCabe's  cyclomatlc,  0  Is  no 
executable  statements,  else  paths 
-  nodes  *  2. 

NJ.INESJSKIPPED 

Int  4 

Number  of  lines  that  were  skipped 
by  the  parser  (ST  SKIP  .. 
ENDJSKIP). 

NJNCLUOES 

Int  4 

Number  of  Include  statements. 

NjOPERATORS 

Int  4 

Number  of  unique  operators. 

NJ)PERATORS_USED 

Int  4 

Number  of  operators  used. 

NOPERANOS 

Int  4 

Number  of  unique  operands. 
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TABLE  -  NAMELIST  DESCRIPTIONS  (Continued) 


Entity 

Type 

(Dimensions) 

Description 

N_0PERAN0S_USED 

Int  4 

Number  of  operands  used. 

N_PRIM_LINES 

Int  4 

Number  of  lines  of  primary  code. 

N_EMBED_LINES 

Int  4 

Number  of  lines  of  embedded  code. 

NJSWITCH 

Int  4 

Number  of  switches  from  primary 
to  embedded  code  and  back. 

N_VARS 

Int  4 

Number  of  variables. 

COOE_COUNTS 

MACS 

Int  4 

20 

Instruction  code  usage  In  a 
procedure. 

HAC_NAME 

Char  16 

MACRO  name. 

DEF_USE_FLAG 

Char  1 

Flag  indicating  whether 
occurance  is  a  definition  or  use 
(D  or  U). 

PROC_NAME 

Char  16 

Defining  module  or  using 

procedure  name. 

NJJSE 

Int  4 

If  DEF_USE_FLAG  -  D  NJJSE  Is 
page  number  of  definition  else 
it  Is  the  number  of  times  used 
In  a  procedure. 

MACjSIZE 

Int  4 

MACRO  size  In  lines. 

PARSER  TABLE 

I NSTRUMENT_VALUE 

Char  15 

User-defined  ASCII  string  that  is 
not  a  valid  construct  of  target 
language  used  to  identify 
instrumentation  lines. 

PARSER_PRNT 

Int  4 

Flag  used  to  turn  on  output  to 
debug  file  PARSER. FIL. 

STRINGS_PRNT 

Int  4 

Flag  used  to  turn  on  output  to 
debug  file  STRIN6S.FIL. 

COMMENT  _PRNT 

Int  4 

Flag  used  to  turn  on  output  to 
debug  file  COMMENT. FIL. 

INSTRM  PRNT 


Int  4 


-60- 


Flag  used  to  turn  on  output  to 
debug  flit  INSTRM.FIL. 


TABLE  -  NAMELIST  DESCRIPTIONS  (Continued) 


Entity 

Type 

(Dimensions) 

Description 

N_ASSM 

Int  4 

Number  of  assembly  language 
mnemonics. 

ASSMJNSTS 

Char  8 

(200) 

Assembly  language  mnemonics. 

ASSM_CODES 

Int  4 

(200) 

Code  for  each  mnemonic. 

ASSM_MODES 

Int  4 

(200) 

Address  mode  for  each  mnemonic. 

ASSMjSPECS 

Int  4 

(200) 

Special  information  about  the 
Instruction. 

NJJSER 

Int  4 

Number  of  user-defined 
instructions. 

USER_INSTS 

Char  8 

(100) 

User  mnemonics. 

USER_CODES 

Int  4 

(100) 

Code  for  each  user  Instruction. 

USER_MODES 

Int  4 

(100) 

Address  mode  for  each  user 
Instruction. 

USER_SPECS 

SCANNER  ERR 

Int  4 

(100) 

Special  information  about  each 
user  Instruction. 

ERROR_CODE 

Char  3 

Error  code. 

ML  »  Multi -line  error. 

IRM  »  Incorrect  Instrumentation 
construct  or  non-comment  In 
abstract. 

MOO_NAME 

Char  31 

Module  name. 

PROC_NAME 

Char  31 

Procedure  name. 

NJLINES 

Int  4 

Line  number  in  the  procedure. 

LINE 

Char  80 

Line  being  scanned. 

BRANCHES  ERR 

MOO_NAME 

Char  31 

Name  of  module. 

PROC_NAME 

Char  31 

Procedure  name. 

ERRORjCODE 

Char  3 

Error  code  (none  currently 
defined). 

TABLE  -  NAMELIST  DESCRIPTIONS  (Continued) 


Entity _  Type  (Dimensions)  _ Description 


N_LINES 

Int  4 

Line  number  in  the  procedure. 

VARUSE  ERR 

MODNAHE 

Char  31 

Module  name. 

ERROR_CODE 

Char  3 

Error  code: 

SRT  »  Sort  failed 

SQMETS  ERR 

ERROR_CODE 

Char  3 

Error  code: 

NML  *  PROC  names  in  namelists 
do  not  match. 

GEN  •  Invalid  assembly 
language  code. 

MOD_NAME 

Char  31 

Module  name. 

PROC_NAME 

Char  31 

Procedure  name. 

NJ.INES 

Int  4 

Line  number  in  the  procedure. 

Line  being  scanned. 


LINE 


Char  80 


In  ACAP,  the  source  code  is  grouped  into  modules  and  procedures  for 
analysis.  A  procedure  is  the  smallest  named  grouping  of  source  code.  A 
module  consists  of  multiple  procedures.  All  of  the  metrics  extracted  by  ACAP 
are  reported  at  the  procedure  and  the  module  level. 

Instrumentation  is  used  to  identify  the  procedures  and  modules  in  the 
assembly  language  source  code  being  analyzed.  In  addition,  instrumentation 
can  be  used  to  identify  abstracts  (or  prologues)  and  to  skip  lines. 
Instrumentation  may  also  serve  a  useful  side  benefit  as  a  mechanism  by  which 
the  analyst  can  tie  a  documented  view  of  a  software  system's  procedures  to  the 
actual  source  code. 

Five  types  of  instrumentation  are  available  to  the  user: 

***  ST_PR0CE0URE  "module  name"  "procedure  name" 

***  ST_ABSTRACT  "module  name"  "procedure  name" 

***  END_ABSTRACT 
***  ST_SKIP 
***  ENDJKIP 

where  ***  Is  a  user  defined  ASCII  string  of  up  to  15  characters  In  length  (see 
Section  3.1.2)  chosen  so  as  to  not  be  a  valid  construct  of  the  target 
language.  "Module  Name"  Is  a  string  Identifying  the  module,  "Procedure  Name" 
Is  a  string  Identifying  the  procedure.  These  strings  may  vary  In  size 
depending  on  the  language  to  be  analyzed,  currently  the  M68000  and  6800 
languages  allow  these  strings  to  be  16  characters  long. 


An  example  of  the  use  of  instrumentation  is  as  follows: 

C**  ST_ABSTRACT  M001  PR0C1 

*  PR0C1  -  SAMPLE  ABSTRACT  FOR  PR0C1 
o 

o 

0 

* 

C**  END_ABSTRACT 

C**  ST_PROCEDURE  MODI  PROC1 

START  EQU  * 

LOA  A  VAR 
o 
o 
o 

END 

C**  STJSKIP 

NAM  'SKIP  ASSEMBLER  DIRECTIVES' 

OPT  PAG 
C**  ENDJSKIP 

C**  ST_PROCEDURE  MODI  PR0C2 
o 
o 
o 

This  example  defines  an  abstract  preceding  a  procedure  and  skips  some 
lines  of  assembly  dl ret Ives  at  the  end  of  the  procedure. 

B.l  PROCEDURE  INSTRUMENTATION 

The  minimum  Instrumentation  that  a  user  of  ACAP  must  utilize  Is  the 
ST_PROCEDURE  line.  ACAP  recognizes  this  line  as  the  start  of  a  new  procedure 
and  the  end  of  the  previous  procedure  (the  first  and  last  procedures  In  a  file 
are  handled  within  their  respective  contexts).  All  comment  lines  between  this 
line  and  the  first  Instruction  in  the  procedure  are,  by  default,  reported  as 
belonging  to  the  abstract  unless  the  abstract  instrumentation  Is  used. 


B.2  ABSTRACT 

Where  appropriate,  the  user  may  override  the  default  processing  for 
abstracts  by  utilizing  the  ST_ABSTRACT  and  END_ABSTRACT  Instrumentation  lines. 
These  will  cause  ACAP  to  associate  the  user  specified  abstract  to  a  specific 
procedure.  ACAP  then  reports  the  total  ntmber  of  lines  In  this  user  defined 
abstract.  In  addition,  any  executable  and  non-executable  statement  lines 
(i.e.,  non-comments)  found  within  the  abstract  are  reported  In  the  ERROR. NML. 

B.3  SKIP 

The  user  may  utilize  the  STJSKIP  and  END_SKIP  instrumentation  lines 
to  "skip"  over  code  within  a  procedure.  Skip  Instrumentation  might  be  used  to 
avoid  ambiguities  arising  from  lines  which  are  conditionally  assembled.  ACAP 
reports  the  number  of  lines  skipped  during  processing. 

Note:  ACAP  will  not  handle  the  case  where  a  subroutine  is 

Instrumented  within  another  instrumented  routine.  Therefore, 
this  practice  should  be  avoided,  the  following  Is  an  example 
of  an  Illegal  Instrumentation: 

C**  ST_PROCEDURE  MODI  PR0C1 

START  EQU  * 

LDA  A  VAR 

o 

o 

C**  ST  PROCEDURE  MODI  PR0C2 
“  SUB  A  #10 
o 
o 
0 

C**  ST_PROCEDURE  M001  PR0C1 
o 
o 
0 

The  occurrence  of  a  "ST_PROCEDURE"  automatically  ends  the 
collection  of  metrics  for  the  previous  procedure  and  the 
previous  procedure  may  not  be  repeated  or  added  to. 


APPENDIX  C 

MODIFICATIONS  NECESSARY  TO  ADD  A 
LANGUAGE  TO  ACAP 


C.l  DEVELOPMENT  OF  NEW  SOFTWARE  ROUTINES 

In  order  to  conform  with  the  current  design  of  ACAP  the  following 
language  specific  programs  need  to  be  developed  for  each  language: 

1.  Scanner:  This  program  prepares  lines  of  instrumented  source 
code  for  parsing  and  accumulates  various  procedure  oriented 
metrics. 

2.  Parser:  This  program  breaks  down  an  Instrumented  source  line 
into  identifiable  language  independent  tokens  and,  for 
applications  requiring  Halsteads  Analysis,  collects  operator  and 
operand  Information.  In  order  to  accomodate  the  Identification 
of  tokens  a  “Parser  Table"  must  be  developed  which  contains 
Information  about  every  Instruction  In  the  the  target  language. 

3.  Parser  Table:  This  Is  a  non-executable  file  with  language 
specific  Information  stored  In  namelist  format.  Each  Parser 
Table  must  be  Identifiable  by  a  unique  name.  At  the  time  of 
language  selection  the  appropriate  parser  table  Is  copied  Into  a 
file  with  the  generic  name  “PARSER. TBl“  and  Is  used  In  various 
programs  until  another  language  selection  Is  made.  See  Appendix 
D  "ACAP  Language  Capabilities"  for  more  specific  Information  on 
the  parser  tables. 

The  end  result  of  the  above  programs  Is  the  file  "TRNSL.FIL".  This 
file  contains  generic  Information  about  the  language  being  analyzed  and  Is  the 
Input  to  the  static  analyzer  programs  which  are,  and  should  remain,  language 
independant. 
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C.2  MODIFICATION  OF  EXISTING  SOFTWARE  ROUTINES 

These  changes  are  basically  to  add  the  new  language  to  the  menu's  so 
It  can  be  selected  by  an  operator. 

1.  ASMCHOICE.MEN,  ACAPCAP.MEN:  Both  of  these  menu's  need  to  have 
the  new  language  name  added. 

2.  ASMCHOICE.COM:  This  program  determines  which  "scanner"  and 
"Parser  Table"  are  to  be  used  in  subsequent  processing  and  puts 
the  source  language  name  in  the  control  file.  Therefore  this 
program  needs  modification  to  add  this  Information  for  any  new 
language. 


APPENDIX  D 

ACAP  LANGUAGE  CAPABILITIES 


6800 


1.  6800  PARSER  TABLE:  The  following  describes  the  Parser  Table 

(P6800.TBL)  used  to  analyze  6800  programs: 


CHARACTER *15  INSTRUMENT_VALUE 

INTEGER  N  USER,  N  ASSM 

INTEGER*4  ASSM  C0DES(200),  ASSM  M0DES(20O) 

INTEGER*4  ASSM“SPECS(200) ,  USER“C0DES(100) 

INTEGER*4  USER~M0DES{100) ,  USER“1SPECS(100) 

INTEGER*4  “PARSER  PRNT,  COMMENT  PRNT,  STRINGS  PRNT, 
INSTRUM  PRNT 


NAMELIST/PARSER  TABLE/ INSTRUMENT  VALUE 


♦ 

.PARSER  PRNT 

* 

.STRINGS'  PRNT 

* 

,COMMENn»RNT 

* 

.INSTRM  PRNT 

* 

,N  ASSM" 

* 

,A5SM  insts 

♦ 

.assjTcooes 

♦ 

,ASSM“MOOES 

* 

.ASSM  SPECS 

♦ 

,N  USER 

* 

,U5tR  INSTS 

* 

.USER  COOES 

* 

.USER~MODES 

* 

,  USER'S PECS 

Where: 


N__ASSM  ■  Number  of  assembly  language  constructs  defined  In 
ASSM_INSTS  that  the  parser  Is  to  recognize.  These  are 
both~instruct1ons  and  assembler  directives. 

ASSM_INSTS  »  The  actual  assembly  language  mnemonics  and  assembler 
directives.  These  can  be  up  to  eight  characters. 

ASSMJCODE  ■  Code  assigned  to  each  entry  in  ASSM__INSTS  which  is  used 
by  the  Static  Analyzer.  The  following  codes  have  been 
defined: 


1m  *«*  *i 


■V 


.*4  .t  t  .»» 


-1  =  Undefined 

1  *  Modifies  Argument 

2  =  References  Argument 

3  *  Tests  Argument 

4  *  Performs  Work 

5  *  Branches  Conditionally 

6  *  Branches  Unconditionally 

7  -  Calls  Subroutine 

8  *  Returns  From  Subroutine 

9  ■  Defines  Argument 

11  «  Declares  Variable 

12  «  Declares  Constant 

13  *  Defines  Constant 

14  >  Performs  Non-Executable  Work 

ASM_M0DE  *  Addressing  mode  or  more  specifically  the  number  of 
operands  that  can  follow  a  particular  instruction. 
Basically,  there  are  three  modes: 

0  ■  No  Operands 

1  *  One  Operands 

2  ■  Two  Operands 

ASSMJSPECS  *  Special  information  about  an  instruction  (not  used  for 
6800  language). 

2.  6800  NON-APPLICABLE  METRICS:  Also  contained  in  the  "Parser 

Table"  Is  a  namelist  which  contains  any  metrics  which  are 
predetermined  to  be  non-appll cable.  The  format  Is  as  follows: 


NAMEIIST/INIT  MET/  N  COMMENT  LINES 
,N  LINES  X  “ 

,n“Lines“Nx 

,N~LINEST 
,N~t0MMENTS  X 

,N”comments“Hx 

,N“tNLINE  CUhMENTS 
,N— PER  COHN  X 
,N-RER""COMM-NX 
,rt*X  m  COMMENTS 
,n  sTamFts  X 
,N”STAMNTS“)1X 
,M01T  LINE“$TAMNTS 
.MULTHSTAMRT  LINES 
,N  ENTRY  PTS” 
,N“BRANCH  FRWO 

,n“Branch-Back 

.nuranchidut 

,N~BRANCH“COND 
,N~BRANCH~ UNCONO 
,N~NOO€S  “ 

,r>ATHS 
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* 

.MCCABES  CYCLOMAT I C 

* 

,N  LINES  SKIPPED 

* 

,N  INCLUDES 

* 

,N  OPERATORS 

it 

.[OPERATORS  USED 

★ 

.NUPERANDS 

* 

,N  OPERANDS  USED 

* 

,N~PRIM  LINTS 

* 

,N“EMBET  LINES 

* 

,N~SWITCF 

♦ 

,N~ VARS 

* 

.CODE  COUNTS 

This  entry  In  the  parser  table  should  contain  ONLY  the  metrics  which 
are  not  applicable.  For  the  6800  language  the  following  are  set  to  -1 
Indicating  non-applicability: 


N_COMMENTS_X 
N  COMMENTS  NX 
N  PER  COMM  X 
N“PERTOMH~hX 

mult  Tine  STamnts 
multOtamTTts  lines 

N  INCLUDES  ~ 

N— OPERATORS 
N'OPERATORS  USED 
N-OPERANDS  ” 

N~ OPERANOS  USED 
N~PRIM  LINFS 
ITEMBEIT  LINES 


3.  6800  LANGUAGE  ANALYSIS  LIMITATIONS: 


1.  Halsteads  parameters  (number  of  unique  operators,  number  of 
operator  occurrences,  number  of  unique  operands,  and  number 
of  operand  occurrences)  are  not  collected. 


2.  Variable  usage  data  relating  more  to  higher  level  language, 
such  as  variable  type  and  number  of  times  a  variable  Is 
passed  as  an  argument,  Is  not  collected. 


Table  D-l  shows  the  content  of  the  Parser  Table  for  the  6800  language 


TABLE  D-l 
6800  PARSER  TABLE 


ASSM-INSTS 

ASSM-CODES 

ASSM-MODES 

Description 

1 

ABA 

4 

0 

Add  Accumulators 

2 

ADC 

2 

2 

Add  With  Carry 

3 

ADD 

2 

2 

Add 

4 

AND 

2 

2 

Logical  And 

5 

ASL 

4 

1 

Arithmetic  Shift  Left 

6 

ASR 

4 

1 

Arithmetic  Shift  Right 

7 

BCC 

5 

1 

Branch  If  Carry  Clear 

8 

BCS 

5 

1 

Branch  If  Carry  Set 

9 

BEQ 

5 

1 

Branch  If  Equal  to  Zero 

10 

BGE 

5 

1 

Branch  If  Greater  or  Equal  Zero 

11 

BGT 

5 

1 

Branch  If  Greater  Than  Zero 

12 

BHI 

5 

1 

Branch  If  Higher 

13 

BIT 

2 

2 

Bit  Test 

14 

BLE 

5 

1 

Branch  If  Less  or  Equal 

15 

BLS 

5 

.  1 

Branch  If  LoMer  or  Sane 

16 

BLT 

5 

1 

Branch  If  Less  Than  Zero 

17 

BMI 

5 

1 

Branch  If  Minus 

18 

BNE 

5 

1 

Branch  If  Not  Equal  to  Zero 

19 

BPL 

5 

1 

Branch  If  Plus 

20 

BRA 

6 

1 

Branch  Always 

21 

BSR 

7 

1 

Branch  to  Subroutine 

22 

BVC 

5 

1 

Branch  If  Overflow  Clear 

23 

BVS 

5 

1 

Branch  If  Overflow  Set 

24 

CBA 

4 

0 

Compare  Accumulators 

25 

CLC 

4 

0 

Clear  Carry 

26 

CLI 

4 

0 

Clear  Interrupt  Mask 

27 

CLR 

1 

1 

Clear 

28 

CLV 

4 

0 

Clear  Overflow 

29 

CMP 

2 

2 

Compare 

30 

COM 

1 

1 

Complement 

31 

CPX 

2 

1 

Compare  Index  Register 

71 


TABLE  D-l  (Continued 
6800  PARSER  TABLE 


ASSM-INSTS 

ASSM -CODES 

ASSM-MODES 

Description 

OAA 

4 

0 

Decimal  Adjust 

DEC 

1 

1 

Decrement 

OES 

4 

0 

Decrement  Stack  Pointer 

DEX 

4 

0 

Decrement  Index  Register 

EOR 

2 

2 

Exclusive  OR 

INC 

1 

1 

Increment 

INS 

4 

0 

Increment  Stack  Pointer 

I  NX 

4 

0 

Increment  Index  Register 

JMP 

6 

1 

Jump 

JSR 

7 

1 

Jump  to  Subroutine 

LOA 

2 

2 

Load  Accumulator 

LOS 

2 

1 

Load  Stack  Pointer 

LOX 

2 

l 

Load  Index  Register 

LSR 

4 

1 

Logical  Shift  Right 

NEG 

1 

1 

Negate 

NOP 

4 

0 

No  Operation 

ORA 

2 

2 

OR  Accumulators 

PSH 

4 

1 

Push  Data 

PUL 

4 

1 

Pull  Data 

ROL 

4 

1 

Rotate  Left 

ROR 

4 

1 

Rotate  Right 

RTI 

8 

0 

Return  From  Interrupt 

RTS 

8 

0 

Return  From  Subroutine 

SBA 

4 

0 

Subtract  Acumulators 

SBC 

2 

2 

Subtract  With  Carry 

SEC 

4 

0 

Set  Carry 

SEI 

4 

0 

Set  Interrupt  Kask 

SEV 

4 

0 

Set  Overflow 

STA 

1 

2 

Store  Accumulator 

STS 

1 

1 

Store  Stack  Register 

STX 

1 

1 

Store  Index  Register 
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TABLE  0-1  (Continued) 
6800  PARSER  TABLE 


ASSM-INSTS 

ASSM -CODES 

ASSM-MODES 

Description 

63 

SUB 

2 

2 

Subtract 

64 

SWI 

4 

0 

Software  Interrupt 

65 

TAB 

4 

0 

Transfer  Accumulators 

66 

TAP 

4 

0 

Transfer  Accumulator  to 

Condition  Code  Register 

67 

TBA 

4 

0 

Transfer  Accumulators 

68 

TPA 

4 

0 

Transfer  Condition  Code  Register 

to  Accumulator 

69 

TST 

2 

0 

Test 

70 

TXS 

4 

0 

Transfer  Stack  Pointer  to  Index 

Regl ster 

71 

TSX 

4 

0 

Transfer  Index  Register  to  Stack 

Pointer 

72 

MAI 

4 

0 

Malt  For  Interrupt 

73 

END 

14 

1 

Define  end  of  Source  Program 

74 

EQU 

13 

1 

Equate  Symbol  to  an  Operand 

75 

FCB 

12 

1 

Form  Constant  Byte 

76 

FCC 

12 

1 

Form  Constant  Characters 

77 

FOB 

12 

1 

Form  Double  Constant  Byte 

78 

NAM 

14 

1 

Specify  Name  of  Title 

79 

OPT 

14 

1 

Control  Assembler  Options 

80 

0R6 

14 

1 

Assign  Origin  of  Program  Counter 

81 

PAG 

14 

1 

Skip  to  Next  Pago 

82 

RMB 

11 

1 

Reserve  Memory  Bytes 

83 

SPC 

14 

1 

Insert  Space(s)  In  Output  File 

73 


i  •168000 


1.  PARSER  TABLE:  The  following  Ascribes  the  parser  table 

(PM68000.TBL)  used  to  analyze  M68000  Programs: 


1 


CHARACTERS 

CHARACTERS  5 

INTEGER 

INTEGERS 

INTEGERS 

INTEGERS 

INTEGERS 


D£L0PER(16) 

INSTRUMENT_VALUE 
N  USER,  N  ASSM,  N  OPER 
ASSM  C0DES(200),  *SSM  MOOES (200) 
ASSM~SPECS(200),  USER_C00ES(100) 

USER  MODES (100),  USER  SPECS (100) 

PARSER  PRNT,  COMMENT  PRNT,  STRINGS  PRNT, 
INSTKUM  PRNT 


NAMEL I  ST/PARSER  _TABLE/ 1 NSTRUMENTJALUE 
.PARSER  PRNT 
.STRING!  PRNT 
,COMMENT“PRNT 
.INSTRM  PRNT 
,N  ASSM 
.ASSM  INSTS 
.ASSfTCODES 

,assM“ modes 

,ASSM“SPECS 
,N  USSR 
.USER  INSTS 
.USER- CODES 
.USERlWDES 
.DELOPER 
.USER  SPECS 


Where: 


NJkSSM,  ASSMJNSTS,  ASSMJCODE  and  ASSM_MOOE  are  defined  as 
In  the  6800  description. 

ASSMJ5PECS  ■  Special  Information  about  an  Instruction. 

0  ■  No  special  Information. 

2  or  9  ■  Are  ASSMjCOOES  which  will  override  the  general  case 
ASSM_C0DE  associated  with  the  particular  Instruction. 

This  will  happen  automatically  when  the  parser  detects 
the  instruction  being  used  In  a  way  that  does  not  fit 
the  general,  default,  case  preset  In  the  ASSM_M00ES  and 
ASSM  COOES. 


USER _ I NSTS ,  USER_CODES,  USER_MODES  and  USERJPECS  are  used  the  same 

as  the  "ASSM"  counterparts  but  for  the  user  defined  instructions  such  as 
macros.  These  are  generated  dynamically. 


DELOPER  *  Delimiting  operators,  those  not  included  in  the 
"ASSM_INSTS"  or  "USER_INSTS",  such  as  arithmetic  operators  (used  for 
Halstead's  calculations). 


N_0PER  *  Number  of  operators  in  the  "DELOPER"  list. 


2.  N68000  NON-APPLICABLE  METRICS:  Also  contained  in  the  "Parser 

Table"  is  a  namelist  which  contains  any  metrics  which  are 
predetermined  to  be  non>appli cable.  The  format  Is  as  follows: 


NAMELIST/INIT  MET/  N_C0MMENT  LINES 
,N  LINES  X 
,N""LINES""NX 
.N1.INES- 
,N  COMMENTS  X 
.NtOMMENTSHiX 
,N  INLINE  COMMENTS 
,N"T>ER  CORN  X 
,N~ PER  COMMIX 
,M*X  WO  COMMENTS 
,N  SlAMNTS  X 
.NHSTAMNTSHM 
.MULT  LINE  STAMNTS 
.MULTSTAMNT  LINES 
,N  ENTRY  PTS“ 
,N"RRANCff  FRWD 
,fT6RANCH”bACK 
.NnSRANCH- OUT 
,N  BRANCH  COND 

,n"6ranch“Uncono 

.fTNODES  ~ 

,n~Raths 

.MCcabes  cyclomatic 

,N  LINES- SKIPPED 
,N“  INCLUDES 
,Nl)PERATORS 
,N  OPERATORS  USED 
^“OPERANDS  - 
.OPERANDS  USED 
,N~PRIM  LINES 
,N-EMBEO  LINES 
,N— SHITCff 


,N  VARS 
.CODE  COUNTS 


* 

* 


This  entry  in  the  parser  table  should  contain  ONLY  the  metrics  which 
are  not  applicable.  For  the  M68000  language  the  following  are  set  to  -1 
indicating  non-applicability: 


N_COMMENTS_X 
N_COMM£NTS_NX 
N_PER_C°MM_X 
N  PER  COMM  NX 
MOLT_riNEjSTAMNTS 
MULT" STAMNTS  LINES 
N  EMBED  LINE! 

N“SWITCTT 

3.  M68000  LANGUAGE  ANALYSIS  LIMITATIONS: 


Variable  usage  data  relating  more  to  higher  level  language, 
such  as  variable  type  and  number  of  time  a  variable  is 
passed  as  an  argument,  is  not  collected. 

Table  D-2  show  the  content  of  the  Parser  Table  for  the  N68000 

language. 


TABLE  D-2 

M68000  PARSER  TABLE 


ASSM-INSTS 

ASSM-MODES 

ASSM-CODES 

ASSM-SPECS 

Description 

ABCD 

2 

4 

0 

Add  Decimal  With  Extend 

ADO 

2 

4 

0 

Add  Binary 

ADDA 

2 

4 

0 

Add  Address 

ADD  I 

2 

4 

0 

Add  Immediate 

ADDQ 

2 

4 

0 

Add  Quick 

ADDX 

2 

4 

0 

Add  Extended 

AND 

2 

4 

0 

AND  Logical 

AND  I 

2 

4 

0 

ADD  Immediate 

ASL 

2 

4 

0 

Arithmetic  Shift 

ASR 

2 

4 

0 

Arithmetic  Shift 

BCC 

1 

5 

0 

Branch  Conditionally 

BCS 

1 

5 

0 

Branch  Conditionally 

BEQ 

1 

5 

0 

Branch  Conditionally 

BGE 

1 

5 

0 

Branch  Conditionally 

BGT 

1 

5 

0 

Branch  Conditionally 

BHI 

1 

5 

0 

Branch  Conditionally 

BLE 

1 

5 

0 

Branch  Conditionally 

BLS 

1 

5 

0 

Branch  Conditionally 

BIT 

1 

5 

0 

Branch  Conditionally 

BMI 

1 

5 

0 

Branch  Conditionally 

BNE 

1 

5 

0 

Branch  Conditionally 

BPL 

1 

5 

0 

Branch  Conditionally 

BVC 

1 

5 

O' 

Test  a  Bit 

BVS 

1 

5 

0 

Test  a  Bit 

BCHG 

2 

4 

0 

Test  a  Bit  and  Change 

BCLR 

2 

4 

0 

Test  a  Bit  and  Clear 

BRA 

1 

6 

0 

Branch  Always 

BSET 

2 

4 

0 

Test  a  Bit  and  Set 

BSR 

1 

7 

0 

Branch  to  Subroutine 

8TST 

2 

4 

2 

Test  a  Bit 

CHK 

2 

5 

0 

Check  Register  Against  Bounds 
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TABLE  0-2  (Continued) 
M68000  PARSER  TABLE 


ASSM-INSTS 

ASSM-MODES 

ASSM-CODES 

ASSM-SPECS 

Description 

CLR 

2 

4 

9 

Clear  an  Operand 

CMP 

2 

4 

0 

Compare 

CMPA 

2 

4 

0 

Compare  Address 

CMP  I 

2 

4 

2 

Compare  Iitmediate 

CMPM 

2 

4 

0 

Compare  Memory 

OBCC 

2 

5 

0 

Test  Condition,  Decrement 

and  Branch 

OBCS 

2 

S 

0 

OBEQ 

2 

5 

0 

DBF 

2 

5 

0 

DBGE 

2 

5 

0 

DBGT 

2 

5 

0 

DBHI 

2 

5 

0 

DBLE 

2 

5 

0 

DBLS 

2 

5 

0 

DBLT 

2 

5 

0 

DBMI 

2 

5 

0 

08NE 

2 

5 

0 

DBPL 

2 

5 

0 

DBT 

2 

5 

0 

OBVC 

2 

5 

0 

DBVS 

2 

5 

0 

DBRA 

2 

6 

0 

DIVS 

2 

4 

0 

Signed  Divide 

DIVU 

2 

4  • 

0 

Unsigned  Divide 

EOR 

2 

4 

0 

Exclusive  OR  Logical 

EORI 

2 

4 

0 

Exclusive  OR  Immediate 

EXG 

2 

4 

0 

Exchange  Registers 

EXT 

1 

4 

0 

Sign  Extend 
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TABLE  0-2  (Continued) 
M68000  PARSER  TABLE 


ASSM-INSTS 

ASSM-MODES 

ASSM-CODES 

ASSM-SPECS 

Description 

JMP 

1 

6 

0 

Jump 

JSR 

1 

7 

0 

Jump  to  Subroutine 

LEA 

2 

4 

0 

Load  Effective  Address 

LINK 

2 

4 

0 

Link  and  Allocate 

LSL 

2 

4 

0 

Logical  Shift 

LSR 

2 

4 

0 

Logical  Shift 

MOVE 

2 

4 

9 

Move  Data  From  Source  To 

Destination 

MOVEA 

2 

4 

U 

Move  Address 

MOVEM 

2 

4 

9 

Move  Mlltiple  Registers 

MOVEP 

2 

4 

0 

Move  Peripheral  Data 

MOVEQ 

2 

4 

0 

Move  Quick 

MULS 

2 

4 

0 

Signed  Multi  ply 

MULU 

2 

4 

0 

Unsigned  Mulltply 

NBCD 

1 

1 

0 

Negate  Decimal  With  Extend 

NEG 

1 

I 

0 

Negate 

NEGX 

1 

1 

0 

Negate  With  Extend 

NOP 

0 

4 

0 

No  Operation 

NOT 

1 

1 

0 

Logical  Complement 

OR 

2 

4 

9 

Inclusive  OR  Logical 

ORI 

2 

4 

9 

Inclusive  OR  Immediate 

PEA 

1 

2 

0 

Push  Effective  Address 

RESET 

0 

4 

0 

Reset  External  Devices 

(Privileged  Instruction) 

ROL 

2 

4 

0 

Rotate  (Without  Extend) 

ROR 

2 

4 

0 

Rotate  (Without  Extend) 

ROXL 

2 

4 

0 

Rotate  With  Extend 

ROXR 

2 

4 

0 

Rotate  With  Extend 

RTE 

0 

8 

0 

Return  From  Exception 

(Privileged  Instruction) 

RTR 

0 

8 

0 

Return  and  Restore  Condition 

Codes 

TABLE  D-2  (Continued 
M68000  PARSER  TABLE 


ASSM-INSTS 

ASSM-HODES 

ASSM-CODES 

ASSH-SPECS 

Description 

RTS 

0 

8 

0 

Return  From  Subroutine 

SBCO 

2 

4 

0 

Subtract  Decimal  With  Extend 

see 

1 

9 

0 

Set  According  to  Condition 

SCS 

1 

9 

0 

SEQ 

1 

9 

0 

SF 

1 

9 

0 

SGE 

1 

9 

0 

SGT 

1 

9 

0 

SHI 

1 

9 

0 

SLE 

1 

9 

0 

SLS 

1 

9 

0 

SLT 

1 

9 

0 

SHI 

1 

9 

0 

SNE 

1 

9 

0 

SPI 

1 

9 

0 

ST 

1 

9 

o 

SVC 

1 

9 

0 

SVS 

1 

9 

0 

STOP 

I 

4 

0 

Load  Status  Register  and  Stop 
(Privileged  Instruction) 

SUB 

2 

4 

0 

Subtract  Binary 

SUBA 

2 

4 

0 

Subtract  Address 

SUBI 

2 

4 

0 

Subtract  Immediate 

SUBQ 

2 

4 

0 

Subtract  Quick 

SUBX 

2 

4 

0 

Subtract  With  Extendd 

SWAP 

1 

4 

0 

Swap  Register  Halves 

TAS 

1 

1 

0 

Test  and  Set  an  Operand 

TRAP 

1 

6 

0 

Trap 

TRAPV 

0 

S 

0 

Trap  on  Overflow 

TST 

1 

4 

0 

Test  an  Operand 

UNLK 

1 

4 

0 

Unlink 

TABLE  0-2  (Continued 
M68000  PARSER  TABLE 


ASSH-INSTS 

ASSM-MODES 

ASSM-CODES 

ASSM-SPECS 

Description 

ENO 

1 

14 

0 

Program  End 

EQU 

1 

13 

0 

Assign  Permanent  Value 

INCLUDE 

1 

14 

0 

Include  Second  File 

OFFSET 

1 

14 

0 

Define  Offsets 

ORG 

1 

14 

0 

Absolute  Origin 

SECTION 

1 

14 

0 

Relocatable  Prog  Section 

REG 

1 

14 

0 

Define  Register  List 

SET 

1 

11 

0 

Assign  Temporary  Value 

INF  EQ 

2 

14 

0 

Conditional  Assembly  Decision 

IFNE 

2 

14 

0 

Conditional  Assembly  Decision 

IFLT 

2 

14 

0 

Conditional  Assembly  Decision. 

IFLE 

2 

14 

0 

Conditional  Assembly  Decision 

IFLE 

2 

14 

0 

Conditional  Assembly  Decision 

IFGT 

2 

14 

0 

Conditional  Assembly  Decision 

IFGE 

2 

14 

0 

Conditional  Assembly  Decision 

ENDC 

0 

14 

0 

End  Conditional  Assembly 

C ONLINE 

1 

12 

0 

Command  Line 

DC 

1 

13 

0 

Define  Constants 

DCB 

2 

13 

0 

Define  Constant  Block 

DS 

1 

12 

0 

Define  Storage 

FAIL 

1 

14 

0 

Programmer  Generated  Error 

FORMAT 

0 

14 

0 

Enable  Auto  Formatting 

NOFORMAT 

0 

14 

0 

Disable  Auto  Formatting 

LIST 

0 

14 

0 

Enable  Listing 

NOL 

0 

14 

0 

Disable  Listing 

NOLIST 

0 

14 

0 

Disable  Listing 

LLEN 

1 

14 

0 

Set  Line  Lengths 

NOOBU 

0 

14 

0 

Disable  Object  Output 

OPT 

0 

14 

0 

Assembler  Options 

PAGE 

0 

14 

0 

Top  of  Page 

NOPAGE 

0 

14 

0 

Disable  Paging 

SPC 

1 

14 

0 

Skip  n  Lines 

TABLE  0-2  (Continued) 
M68000  PARSER  TABLE 


ASSM-INSTS  ASSM-MODES 


TTL  1 

IDNT  0 

XOEF  1 

XREF  1 

IF  0 

ELSE  0 

ENDI  0 

FOR  0 

ENDF  0 

REPEAT  0 

UNTIL  0 

WHILE  0 

ENDW  0 


ASSM-COOES  ASSH-SPECS 


14  0 

14  0 

11  0 

11  0 

3  0 

3  0 

14  0 

3  0 

14  0 

14  0 

3  0 

3  0 

14  Q 


_ Description 

Title 

Relocatable  ID  Record 
External  Symbol  Def 
External  Symbol  Ref 
Structured  Constructs 
Structured  Constructs 
Structured  Constructs 
Structured  Constructs 
Structured  Constructs 
Structured  Constructs 
Structured  Constructs 
Structured  Constructs 
Structured  Constructs 
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SKC 

1.  PARSER  TABLE:  The  following  describes  the  parser  table 

(PSKC.TBL)  used  to  analyze  SKC  Programs: 


CHARACTERS 

DELOPER (16) 

CHARACTERS 

INSTRUMENT  VALUE 

INTEGER 

N  USER,  N  *SSM,  N  OPER 

INTEGERS 

AlSM  C0DEl(25O),  *SSM  M0DES(250) 

INTEGERS 

ASSM~SPECS(250  ,  USER'CODES  (100) 

INTEGERS 

USER-MODES (100),  USER“5PECS(100) 

INTEGERS 

PARSER  PRNT,  COMMENT  PRNT,  STRINGS  PRNT 
INSTRllM  PRNT 

NAMELIST/PARSER  TABLE/ INSTRUMENT  VALUE 

♦ 

.PARSER  PRNT 

* 

.STRINGS'  PRNT 

it 

,COMMENf>RNT 

* 

, INSTRM  PRNT 

* 

,N  ASSM” 

* 

•ASSM  INSTS 

* 

,ASSM~CODES 

* 

.ASSMUODES 

* 

,ASSM  SPECS 

* 

,USER~CODES 

* 

.USER-MODES 

* 

.USER  SPECS 

* 

.DELOPER 

* 

,N  OPER 

Where: 


N_ASSM,  ASSMJNSTS,  ASSM_C0DE  and  ASSM_MOOE  are  defined  as 
In  the  6800  description. 


ASSM_SPECS  ■  Special  Information  about  an  Instruction  (not  used  for 
SKC).  USERJNSTS,  USER_C00ES,  US£R_H00ES  and  USER_SPECS  are  used  the  same  as 
the  "ASSM"  counterparts  but  for  the  user  defined  Instructions  such  as  macros. 
These  are  generated  dynamically. 


DELOPER  ■  Delimiting  operators,  those  not  Included  In  the 
"ASSM_INSTS“  or  "USER_INSTS",  such  as  arithmetic  operators  (used  for 
Halstead's  calculations). 


NJOPER  ■  Number  of  operators  In  the  •DELOPER"  list. 
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2.  SKC  N0N-APPLICA8LE  METRICS:  Also  contained  in  the  "Parser 
Table"  is  a  namelist  which  contains  any  metrics  which  are 
predetermined  to  be  non-appl i cable.  The  format  is  as  follows: 


NAMELIST/INIT  MET/  N  COMMENT  LINES 


★ 

,N  LINES  X  ~ 

* 

,N~LlNES~ NX 

♦ 

,N  LINES 

★ 

,N~COMMENTS  X 

★ 

,N“COMMENTS~NX 

* 

,N  INLINE  COMMENTS 

* 

,N~ PER  COHM  X 

* 

,N~PER_COMM~NX 

it 

,MJTx  WO  COMMENTS 

it 

,N  STAMNTS  X 

it 

,N“stamnts“Nx 

it 

.MULT  LINE'STAMNTS 

it 

.MULTSTAMNT  LINES 

it 

,N  ENTRY  PTST 

it 

,N  BRANCH  FRWD 

it 

,N“BRANCH~BACK 

it 

.ORANCH  OUT 

it 

.N  BRANCH  COND 

it 

,N~Branch  uncond 

it 

.ITNODES  ” 

it 

,N~PATHS 

it 

.MCCABES  CYCLOMATIC 

♦ 

,N  LINESlSKIPPED 

* 

,N  INCLUDES 

* 

.NDPERATORS 

* 

.NDPERATORS  USED 

* 

,N~I OPERANDS  “ 

* 

,N  OPERANDS  USED 

* 

.(TPRIM  LINK 

* 

,n“embed  LINES 

* 

.iCSWITCff 

* 

.rrvARs 

* 

.CODE  COUNTS 

This  entry  In  the  parser  table  should  contain  ONLY  the  metrics  which 
are  not  applicable.  For  the  SKC  language  the  following  are  set  to  -1 
Indicating  non-applicability: 


N  COMMENTS  X 
N"C0MMENTS“NX 
N“PER  COMfTX 

nHperHcomm- NX 
ninciudes- 

MOlT  LINE  STAMNTS 
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MULT_STAMNTS _ LINES 

N  EMBED  LINES 
fTSWITCF 

3.  SKC  LANGUAGE  ANALYSIS  LIMITATIONS: 

a.  Variable  usage  data  relating  more  to  higher  level 
language,  such  as  variable  type  and  number  of  time  a 
variable  Is  passed  as  an  argument.  Is  not  collected. 

b.  Metrics  for  lines  which  make  up  a  Macro  Definition  are 
not  collected.  However,  Macro  Definition  and  Usage 
Information  can  be  found  In  the  Macro  Report. 

Table  D-3  show  the  content  of  the  Parser  Table  for  the  SKC  language. 


TABLE  D-3 
SKC  PARSER  TABLE 


ASSM  INSTS 

C 

M 

DESCRIPTION 

ADD  16 

2 

2 

Add  16  bits. 

ADD  3  2 

2 

2 

Add  32  bits. 

ADOR 

2 

2 

Add  general  register. 

ADF 

2 

2 

Add  floating. 

AFD 

2 

2 

Add  floating  DP. 

A  NO  16 

2 

2 

Logical  AND  16  bits. 

AN032 

2 

2 

Logical  AW)  32  bits. 

CBIT 

2 

2 

Compare  bit  In  memory. 

C0M16 

2 

2 

Compare  16  bits. 

C0M32 

2 

2 

Compare  32  bits. 

COMF 

2 

2 

Compare  floating. 

COMFD 

2 

2 

Compare  floating  DP. 

OR 

2 

2 

Compare  general  register. 

DV016 

2 

2 

Divide  16  bits. 

DVOX16 

2 

2 

Divide  extended  precision  16  bits. 

DV032 

2 

2 

Divide  32  bits. 

DVDX32 

2 

2 

Divide  extended  precision  32  bits. 

DVF 

2 

2 

Divide  floating. 

EXEC 

2 

1 

Execute. 

EX016 

2 

2 

Exclusive  OR  16  bits. 

EX032 

2 

2 

Exclusive  OR  32  bits. 

IDVF 

2 

2 

Inverse  divide  floating. 

ISBF 

2 

2 

Inverse  subtract  floating. 

ISFO 

2 

2 

Inverse  subtract  floating  DP. 

LAE 

4 

1 

Load  AU  with  ffctlve  address. 

L016 

2 

2 

Load  16  bits. 

L032 

2 

2 

Load  32  bits. 

L064 

2 

2 

Load  64  bits. 

LDMK 

2 

2 

Load  mask  register  (not  available  on  SKC3121) 

LOPUSH 

2 

2 

Load  32  bits  and  push. 

LOR 

2 

2 

Load  general  register. 

LHMR 

2 

2 

Load  memory  management  RAM  (not  available  on 
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TABLE  0-3  (Continued 
SKC  PARSER  TABLE 


ASSM  INSTS  C 


MLF  2 

HLFT  2 

HUL16  2 

MUL32  2 

MULR  2 

OR  16  2 

OR32  2 

RBIT  1 

RDVF  2 

RESTORE  2 

RIDVF  2 

RTA  6 

RTAP  6 

SAVE  9 

SBF  2 

SBIT  1 

SFD  2 

ST16  9 

ST32  9 

ST64  9 

STPOP  9 

STR  9 

SUB16  2 

SUB32  2 

SUBR  2 

TBIT  1 

ABS16  4 

ABS32  4 

ABSF  4 

ABSFO  2 

CFX  4 


M_ _ DESCRIPTION _ 

2  Multiply  floating. 

2  Multiply  floating  truncated. 

2  Multiply  16  bits. 

2  Multiply  32  bits. 

2  Multiply  general  register. 

2  Logical  OR  16  bits. 

2  Logical  OR  32  bits. 

2  Reset  bit  In  memory. 

2  Remainder  divide  floating. 

2  Load  block  of  registers. 

2  Remainder  Inverse  divide  floating. 

2  Return  jump. 

2  Return  from  priority  program  Interrupts  (not 
available  on  SKC  3121). 

2  Store  block  of  registers. 

2  Subtract  floating. 

2  Set  bit  in  memory. 

2  Subtract  floating. 

2  Store  16  bits. 

2  Store  32  bits. 

2  Store  64  bits. 

2  Store  32  bits  and  pop. 

2  Store  general  register. 

2  Subtract  16  bits. 

2  Subtract  32  bits. 

2  Subtract  general  register. 

2  Toggle  bit  In  memory. 

0  Absolute  value  -  16  bit. 

0  Absolute  value  -  32  bit. 

0  Absolute  value  -  floating  point. 

2  Absolute  value  -  floating  point. 

0  Convert  floating  to  fixed  point. 
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TABLE  D-3  (Continued 
SKC  PARSER  TABLE 


ASSM  INSTS 

C 

M 

DESCRIPTION 

CL16 

4 

0 

Clear  16  bits. 

CL32 

4 

0 

Clear  32  bits. 

CL32F 

4 

0 

Clear  32  bits  floating. 

CL64F 

4 

0 

Clear  64  bits  floating. 

CLB 

4 

0 

Clear  B  register. 

CLR 

4 

1 

Clear  general  register. 

CXF 

4 

0 

Convert  fixed  to  floating  point. 

DPI 

4 

0 

Disable  program  Interrupts. 

EPI 

4 

0 

Enable  program  Interrupts. 

EPPI 

4 

0 

Enable  priority  program  Interrupts. 

EXAB 

4 

0 

Exchange  A  and  B  register. 

EXTDV 

4 

0 

Use  extended  precision  numerator  in  following  divide 

HALT 

4 

0 

Halt  the  CPU. 

LRA 

4 

1 

Load  register  from  AU  register. 

LAR 

4 

1 

Load  AU  register  from  general  register. 

NE616 

4 

0 

Negate  (two's  complement)  16  bits. 

NEG32 

4 

0 

Negate  (two's  complement)  32  bits. 

NEGF 

4 

0 

Negate  floating  point. 

NE6FD 

4 

0 

Negate  floating  point  double  precision. 

NEGR 

4 

1 

Negate  (two's  complement)  general  register. 

N0T16 

4 

0 

Not  (one's  complement)  16  bits. 

NOT32 

4 

0 

Not  (one's  complement)  32  bits. 

SORT 

4 

0 

Square-root-floating  point. 

SQUARE 

4 

0 

Square-floating  point. 

AOORR 

4 

2 

Add  register  to1  register. 

ANORR 

4 

2 

Logical  AND  register  with  register. 

CORR 

4 

2 

Compare  register  with  register. 

DVORR 

4 

2 

01  vide  register  by  register  Integer. 

EXORR 

4 

2 

Exclusive  OR  register  with  register. 

EXRR 

4 

2 

Exchange  register  with  register. 

LDRR 

4 

2 

Load  register  to  register. 

UPC 

4 

2 

Load  general  register  with  PC. 
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SKC  PARSER  TABLE 


ASSM  INSTS 

C 

H 

DESCRIPTION 

HULRR 

4 

2 

Multiply  register  by  register  integer. 

ORRR 

4 

2 

Logical  OR  register  with  register. 

SLCR 

4 

2 

Shift  left  circular  register. 

SLLR 

4 

2 

Shift  left  logical  register. 

SRAR 

4 

2 

Shift  right  algebraic  register. 

SRLR 

4 

2 

Shift  right  logical  register. 

SUBRR 

4 

2 

Subtract  register  from  register. 

SLC 

2 

2 

Shift  left  circular. 

SLCD 

2 

2 

Shift  left  circular  double. 

SLL 

2 

2 

Shift  left  logical. 

SLLD 

2 

2 

Shift  right  logical  double. 

SRAO 

2 

2 

Shift  right  algebraic  double. 

SRC 

2 

2 

Shift  right  circular. 

SRCO 

2 

2 

Shift  right  circular  double. 

SRLO 

2 

2 

Shift  right  logical  double. 

INI 

4 

1 

Input  direct. 

IN2 

2 

2 

Input  via  memory. 

OUT1 

4 

1 

Output  direct. 

0UT2 

2 

2 

Output  via  memory. 

JEQ 

5 

2 

Jump  equal. 

J6E 

5 

2 

Jump  greater  than  or  equal. 

JGT 

S 

2 

Jump  greater  than. 

JLE 

5 

2 

Jump  less  than  or  equal. 

JLT 

5 

2 

Jump  less  than. 

JNE 

5 

2 

Jump  not  equal. 

JSA 

7 

2 

Subroutine  jump-absolute. 

JSAI 

7 

2 

Subroutine  jump-absolute  indirect. 

JSAIR 

7 

2 

Subroutine  jump-absolute  indirect  relative 

JSR 

7 

2 

Subroutine  jump-relative. 

JSR  I 

7 

2 

Subroutine  jump-relative  Indirect. 

JU 

6 

2 

Jump  unconditional. 

JUA 

6 

2 

Jump  unconditional  absolute. 
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SKC  PARSER  TABLE 


ASSM  INSTS 

C 

M 

DESCRIPTION 

JUAI 

6 

2 

Jump  unconditional  absolute  Indirect. 

JUAIR 

6 

2 

Jump  unconditional  absolute  Indirect  relative 

JURI 

6 

2 

Jump  relative  indirect. 

ADFS 

4 

0 

Add  stack  floating  point. 

COMFS 

4 

0 

Compare  stack  floating  point. 

DVFS 

4 

0 

Divide  stack  floating  point. 

IDVFS 

4 

0 

Inverse  divide  stack  floating  point. 

ISBFS 

4 

0 

Inverse  subract  stack  floating  point. 

MLFS 

4 

0 

Multiply  stack  floating  point. 

POP 

4 

0 

Pop  the  stack. 

PUSH 

4 

0 

Push  the  stack. 

SBFS 

4 

0 

Subtract  stack  floating  point. 

PROL 

2 

2 

Fixed  prologue. 

PROLS 

2 

2 

Fixed  prologure  and  save. 

PROLV 

2 

1 

Variable  prologue. 

PROL  VS 

2 

1 

Variable  prologue  and  save. 

RETURN 

8 

0 

Return  from  subroutine. 

BMOVE 

4 

1 

Block  move. 

TRAPX16 

2 

2 

Trap  16  bits  fixed  point. 

TRAPX32 

2 

2 

Trap  32  bits  fixed  point. 

TRAPF32 

2 

2 

Trap  32  bits  floating  point. 

TRAPF64 

2 

2 

Trap  64  bits  floating  point. 

DVFO 

2 

2 

Divide  floating  DP. 

IDVFD 

2 

2 

Inverse  divide  floating  DP. 

NLFD 

2 

2 

Multiply  floating  DP. 

NOP 

4 

0 

No  operation. 

AORS 

13 

1 

ADdReSs. 

VFD 

11 

2 

Varlabl  field  definition. 

ASCII 

12 

1 

ASCII  characters. 

ASCI IP 

12 

1 

ASCII  characters. 

EQU 

13 

1 

EQUate. 

SETD 

13 

1 

Define  SET  symbol -Decimal . 
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ABLE  0~3  (Continued 
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ASSM  IN STS 

C 

M 

DESCRIPTION 

SETX 

13 

1 

Define  SET  symbol -heX. 

BIT 

13 

2 

Define  BIT  symbol. 

BASE 

14 

1 

Activate  BASE  register. 

DBASE 

14 

1 

Deactivate  BASE  register. 

UBASE 

14 

1 

Unconditional  BASE  register. 

ENTRY 

14 

1 

ENTRY  point  list. 

GDATA 

14 

0 

Global  DATA  list. 

MAIN 

14 

0 

MAIN  deck. 

END 

14 

0 

END  of  deck. 

INT 

14 

0 

INTerrupt  deck. 

LIST 

14 

0 

Source  LISTing. 

USE 

14 

1 

USE  location  counter. 

ORG 

14 

0 

Absolute  ORiGIn. 

EVEN 

14 

0 

EVEN  location. 

COMMON 

14 

0 

COMMON  data  region. 

BSTACK 

11 

1 

Block  STACK. 

DEC16 

13 

1 

DECImal  data  (16  bits). 

0EC32 

13 

1 

DECimal  data  (32  bits). 

DEC64 

13 

1 

OECimal  data  (64  bits). 

HEX16 

13 

1 

HEXadecimal  data  (16  bits). 

HEX32 

13 

1 

HEXadecimal  data  (32  bits). 

HEX64 

13 

1 

HEXadecimal  data  (64  bits). 

SCLB16 

13 

2 

SCaLed  Binary  data  (16  bits). 

SCLB32 

13 

2 

SCaLed  Binary  data  (32  bits). 

SCLW16 

13 

2 

SCaLed  Weighted  data  (16  bits). 

SCLW32 

13 

2 

SCaLed  Weighted  data  (32  bits). 

BSS 

11 

1 

Block  Started  by  Symbol. 

BES 

11 

1 

B1 ock  Ended  by  Symbol . 

UNLIST 

14 

0 

UNdo  source. 

TTL 

14 

0 

TITLe. 

EJECT 

14 

0 

EJECT  rest  of  page. 

SPACE 

14 

0 

SPACE  by  d  lines. 
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TABLE  0-3  (Continued 
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ASSM  INSTS 

C 

M 

DESCRIPTION 

CSB 

14 

0 

Compool  Symbols  Begin. 

CPOOL 

14 

1 

Declare  ComPOOL  symbol. 

CSE 

14 

0 

Compool  Symbols  End. 

PTR16 

2 

2 

PoinTeR  16. 

PTR32 

2 

2 

PoinTeR  32. 

PTR64 

2 

2 

PoinTeR  64. 

SBITM 

1 

2 

Set  BIT  Marco. 

RBITN 

1 

‘2 

Reset  BIT  Marco. 

TBITM 

1 

2 

Toggle  BIT  Marco. 

CBITH 

2 

2 

Compare  BIT  Macro. 

JBIT1 

5 

2 

Jump  If  BIT  Is  1. 

JBITO 

5 

2 

Jump  If  BIT  Is  0. 

ATI 

14 

0 

Memory  Access  Time  of  Instruction 

ATO 

14 

0 

Memory  Access  Time  of  Operand. 

ATIME 

CTI 

14 

0 

Execution  Timing  weight. 

Memory  Cycle  Time  of  Instruction. 

CTO 

14 

0 

Memory  Cycle  Time  of  Operand. 
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1.  PARSER  TABLE:  The  following  describes  the  parser  table 

(PDP11.TBL)  used  to  analyze  PDP11  Programs: 


CHARACTERS 

CHARACTERS  5 

INTEGER 

INTEGER*4 

INTEGER*4 

INTEG£R*4 

INTEGER*4 


DELOPER (16) 

INSTRUMENT_VALUE 

N  USER,  N  ASSM,  N  OPER 

ASSM  C0DET(200),  XSSM_M0DES(200) 

ASSM  SPECS (200) ,  USER  CODES(IOO) 

USER- MOFRO(IOO) ,  USER  SPECS(IOO) 

PARSlR  PRNT,  COMMENT  PfeNT,  STRINGS  PRNT, 
INSTlflJM  PRNT 


NAMEL I ST/PARSER  _TABLE/ I NSTRUMENT_VALUE 


* 

.PARSER  PRNT 

♦ 

.STRINGS’  PRNT 

* 

,COMMENT—PRNT 

* 

, INSTRM  PRNT 

* 

,N  ASSM 

* 

,A5SM  INSTS 

* 

.ASSM  CODES 

★ 

,ASSM~MODES 

it 

,ASSM~$PECS 

♦ 

,N  usth 

* 

.USER  INSTS 

* 

.USER- CODES 

♦ 

,USER""MODES 

* 

.DELOPER 

* 

.USER  SPECS 

Where: 


N_ASSM,  ASSMJNSTS,  ASSMJCOOE  and  ASSM_MOOE  arc  defined  as 
In  the  $800  description. 


USERJNSTS,  USERjCODES,  and  USERJIODES  are  used  the  same  as  the 
"ASSM"  counterparts  but  for  the  user  defined  Instructions  such  as  macros. 
These  are  generated  dynamically. 

DELOPER  ■  Delimiting  operators,  those  not  Included  In  the 
"ASSM_INSTS"  or  "USER_INSTS",  such  as  arithmetic  operators  (used  for 
Halstead's  calculations). 


N_OPER  »  Number  of  operators  in  the  "DELOPER"  list. 

2.  POP11  NON-APPLICABLE  METRICS:  Also  contained  in  the  "Parser 
Table"  is  a  namelist  which  contains  any  metrics  which  are 
predetermined  to  be  non-appli cable.  The  format  is  as  follows: 


NAMELIST/INIT  MET/  N  COMMENT_LINES 

,n  Ones  x 
,itlines"Nx 

.NllNES- 
,N“COMMENTS  X 
.NtOMMENTSHX 
,N  INLINE  CflHMENTS  * 
,N“PER  CORN  X 
,N~ PER~C0MM— NX 
^X  Wff  COMMENTS 
,N  STAMRTS  X 
,N“STAMNTSTNX 
,t€TLT  LINE  STAMNTS 
.MULT  STAMUt  LINES 
,N  ENTRY  PTS” 
,N~bRANCff  FRWO 
,N~"&RANCH~BACK 
.ITSRANCHUUT 
,N“ BRANCH  CONO 

,n-Branch“\jncond 

.rnwoes  ~ 

.iTPaths 

.MCcabes  cyclomatic 

.N  LINES~SKIPPEO 
,N“ INCLUDES 
.NDPERATORS 

.operators  used 

.NDPERANOS  ” 
.NDPERANOS  used 
.iTPrim  lines 

.fTEMSEU  LINES 
.(TSWITCW 
.fTVARS 
.CODE  COUNTS 


This  entry  In  the  parser  table  should  contain  ONLY  the  metrics  which 
are  not  applicable.  For  the  P0P11  language  the  following  are  set  to  -1 
Indicating  non-applicability: 


N  COMMENTS  X 
N— COMMENTS  NX 
ITPER  COMMK 
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N_PER_COMH  NX 
MULT  LINE  STAMMS 
MULfSTAMNTS  LINES 
N  EMBED  LINE? 

N~S  WITCH 

3.  PDP11  LANGUAGE  ANALYSIS  LIMITATIONS:  Variable  usage  data 
relating  more  to  higher  level  language,  such  as  variable  type 
and  number  of  time  a  variable  is  passed  as  an  argument,  is  not 
collected. 


Data  on  nested  macro  definitions  is  not  collected.  Table  D-4  shows 
the  content  of  the  Parser  Table  for  the  PDPU  language. 


TABLE  0-4 

PDP11  PARSER  TABLE 


ASSM-INSTS 

ASSM-MODES 

ASSM-CODES 

Description 

ADC 

4 

1 

Add  Carry 

ADCB 

4 

1 

Add  Carry  (Byte) 

ADD 

4 

2 

Add  Source  to  Destination 

ASH 

4 

2 

Shift  Arithmetically 

ASHC 

4 

2 

Arithmetic  Shift  Combined 

ASL 

4 

1 

Arithmetic  Shift  Left 

ASLB 

4 

1 

Arithmetic  Shift  Left  (Byte) 

ASR 

4 

1 

Arithmetic  Shift  Right 

ASRB 

4 

1 

Arithmetic  Shift  Right  (Byte) 

BCC 

5 

1 

Branch  If  Carry  Is  Clear 

BCS 

5 

1 

Branch  if  Carry  Is  Set 

BEQ 

5 

1 

Branch  if  Equal 

BHE 

5 

I 

Branch  If  Greater  Than  or  Equal 

BGT 

5 

I 

Branch  If  Greater  Than 

BHI 

5 

1 

Branch  if  Higher 

BHIS 

5 

1 

Branch  If  Higher  or  Same 

BIC 

4 

2 

Bit  Clear 

BICB 

4 

2 

Bit  Clear  (Byte) 

BIS 

4 

2 

Bit  Set 

BISB 

4 

2 

Bit  Set  (Byte) 

BIT 

3 

2 

Bit  Test 

BITB 

3 

2 

Bit  Test  (Byte) 

BLE 

5 

1 

Branch  if  Less  Than  or  Equal 

BLO 

5 

1 

Branch  if  Lower 

BLOS 

5 

1 

Branch  If  Lower  or  Same 

BIT 

5 

1 

Branch  If  Less  Than 

BMI 

5 

1 

Branch  If  Minus 

BNE 

5 

1 

Branch  if  Not  Equal 

BPL 

S 

1 

Branch  If  Plus 

BPT 

6 

0 

Breakpoint  Trap 

BR 

6 

1 

Branch  Unconditional 

BVC 

S 

1 

Branch  If  Overflow  Is  Clear 
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TABLE  0-4  (Continued 
POP 11  PARSER  TABLE 


ASSM-INSTS 

ASSM-MODES 

ASSM-CODES 

Description 

BVS 

5 

1 

Branch  Is  Overflow  Is  Set 

CALL 

7 

1 

Jump  to  Subroutine  (JSR  PC,  xxx) 

CCC 

4 

0 

Clear  All  Condition  Codes 

CLC 

4 

0 

Clear  C  Condition  Code  Bit 

CLN 

4 

0 

Clear  N  Condition  Code  Bit 

CLR 

4 

1 

Clear  Destination 

CLRB 

4 

1 

Clear  Destination  (Byte) 

CLV 

4 

0 

Clear  V  Condition  Code  Bit 

CLZ 

4 

0 

Clear  Z  Condition  Code  Bit 

CMP 

3 

2 

Compare  Source  to  Destination 

CMPB 

3 

1 

Complement  Destination 

COM 

4 

1 

Complement  Destination 

COMB 

4 

1 

Complement  Destination  (Byte) 

DEC 

1 

1 

Decrement  Destination 

DECB 

1 

1 

Decrement  Destination  (Byte) 

DIV 

4 

2 

Divide 

EMT 

6 

0 

Emulator  Trap 

FADO 

4 

2 

Floating  Add 

FDIV 

4 

2 

Floating  Divide 

FMUL 

4 

2 

Floating  Multiply 

FSU8 

4 

2 

Floating  Subtract 

HALT 

4 

0 

Halt 

INC 

1 

1 

Increment  Destination 

INCB 

1 

1 

Increment  Destination  (Byte) 

IOT 

6 

0 

Input/Output  Trap 

JMP 

6 

1 

Jump 

JSR 

7 

2 

Jump  to  Subroutine 

MARX 

4 

1 

Mark 

MFPI 

4 

l 

Move  From  Previous  Instruction  Space 

MFPS 

4 

1 

Move  From  PS  (ISI-U) 

MOV 

4 

2 

Move  Source  to  Destination 

MOVB 

4 

2 

Move  Source  to  Destination  (Byte) 
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ASSH-INSTS 

MTPI 

MTPS 

MUL 

NEG 

NEG8 

NOP 

RESET 

RETURN 

ROL 

ROLB 

ROR 

RORB 

RTI 

RTS 

RTT 

SBC 

SBCB 

SCC 

SEC 

SEN 

SEV 

SEZ 

SOB 

SUB 

SWAB 

SXT 

TRAP 

TST 

TSTB 

MAIT 


TABLE  0-4  (Continued) 
POPU  PARSER  TABLE 


ASSM-MOOES  ASSN-CODES 


Description 


4 

4 

4 

1 

1 

4 

4 

8 

4 

4 

4 

4 

6 

8 

8 

4 

4 
1 
1 
1 
1 
1 

5 
4 
4 
4 

6 
3 

3 

4 


1 

1 

2 

1 

1 

1 

0 

0 

1 

1 

1 

1 

0 

1 

0 

1 

1 

0 

0 

0 

0 

0 

2 

2 

1 

1 

1 

1 

1 

0 


Hove  to  Previous  Instruction  Space 
Move  to  PS(LSI-ll) 

Multiply 

Negate  Destination 
Negate  Destination  (Byte) 

No  Operation 

Reset  External  Bus 

Return  From  Subroutine  (RTS  PC) 

Rotate  Left 
Rotate  Left  (Byte) 

Rotate  Right 
Rotate  Right  (Byte) 

Return  From  Interrupt  ( Penal ts  a  Trace 
Trap) 

Return  From  Subroutine 
Return  From  Interrupt  (Inhibits  Trace 
Trap) 

Subtract  Carry 
Subtract  Carry  (Byte) 

Set  All  Condition  Code  Bits 

Set  C  Condition  Code  Bit 

Set  N  Condition  Code  Bit 

Set  V  Condition  Code  Bit 

Set  Z  Condition  Code  Bit 

Subtract  One  And  Branch 

Subtract  Source  From  Destination 

Swap  Bytes 

Sign  Extend 

Trap 

Test  Destination 
Test  Destination  (Byte) 

Malt  For  Interrupt 
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TABLE  0-4  (Continued 
POP 11  PARSER  TABLE 


ASSM-INSTS 

ASSM-MODES 

ASSM-CODES 

Description 

XOR 

4 

2 

Exclusive  OR 

.ASCII 

14 

0 

Translates  character  string  to  ASCII 
equivlents. 

.ASCIZ 

14 

0 

Translates  character  string  to  ASCII 
equivalents;  inserts  zero  byte  as  last 
character. 

.ASECT 

14 

0 

Begins  absolute  program  section  (provided 
for  compatibility  with  other  P0P11 
assembl iers) . 

.BLKB 

14 

0 

Reserves  byte  block  In  accordance  with 
value  of  specified  argument. 

•  BLKW 

14 

0 

Reserves  word  block  In  accordance  with 
value  of  specified  argument. 

.BYTE 

14 

0 

Generates  successive  byte  data  In 
accordance  with  specified  arguments. 

.CSECT 

14 

0 

Begins  relocatable  program  section 
(provided  for  compatibility  with  other 
P0P11  assemblers). 

.DSABL 

14 

0 

Disables  spelfled  function. 

.ENABL 

14 

0 

Enables  specified  function. 

.END 

14 

0 

Defines  logical  end  of  source  program. 

.ENDC 

14 

0 

Defines  end  of  conditional  assembly  block 

.ENOR 

14 

0 

Defines  end  of  current  repeat  block 
(provided  for  compatibility  with  other 
PDP11  assemblers). 

.EOT 

14 

0 

Define  End  of  Tap  Condition  (Ignored). 

.ERROR 

14 

0 

Outputs  diagnostic  message  to  listing 
fllo  or  command  output  device. 

.FLT2 

14 

0 

Causes  two  words  of  storage  to  be 
generated  for  each  floating-point 
argument. 

TABLE  0-4  (Continued) 
PDP11  PARSER  TABLE 


ASSM-INSTS 

ASSM-MOOES 

ASSM-CODES 

Description 

.FLT4 

Causes  four  words  of  storage  to  be 
generated  for  each  floating-point 
argument. 

.GLOBL 

14 

0 

Declares  global  attribute  for  specified 
symbol (s). 

.IDENT 

14 

0 

Labels  object  module  with  specified 
program  version  number. 

. IF 

14 

0 

Begins  conditional  assembly  block. 

.IFF 

14 

0 

Begins  subcondltlonal  assembly  block  (If 
conditional  assembly  block  test  Is  false) 

.IFT 

14 

0 

Begins  subconditional  assembly  block  (If 
conditional  assembly  block  test  Is  true). 

.  IFTF 

14 

0 

Begins  subconditional  assembly  block 
(whether  conditional  assembly  block  test 
Is  true  or  false). 

•  I  IF 

14 

0 

Assembles  Immediate  conditional  assembly 
statement  (If  specified  condition  is 
satisfied). 

.  IRP 

14 

0 

Begins  Indefinite  repeat  block;  replaces 
specified  symbol  with  specified 
successive  real  arguments. 

•  IRPC 

14 

0 

Begins  indefinite  repear  block;  replaces 
specified  symbol  with  value  of  successive 
characters  In  specified  string. 

.LIMIT 

14 

0 

Reserves  two  words  of  storage  for  high 
and  low  addresses  of  task  Image. 

.LIST 

14 

0 

Controls  listing  level  count  and  format 
of  assembly  listing.  MACRO  denotes  start 
of  macro  definition. 

.MCALL 

14 

0 

Identifies  required  macro  deflnltlon(s) 
for  assembly. 

MEXIT 


14 


0 


Exit  fro*  current  macro  definition  or 
Indefinite  repeat  block. 


TABLE  0-4  (Continued) 
POP 11  PARSER  TABLE 


ASSM-INSTS 

ASSM-MOOES 

ASSM-CODES 

Description 

.NARG 

14 

0 

Equates  specified  symbol  to  the  number  of 
arguments  in  the  macro  expansion. 

.  NCHR 

14 

0 

Equates  specified  symbol  to  the  number  of 
characters  in  the  specified  character 
string. 

.NLIST 

14 

0 

Controls  listing  level  count  and 
suppresses  specified  portions  of  the 
assembly  listing. 

.NTYPE 

14 

0 

Equates  specified  symbols  to  the 
addressing  mode  of  the  specified  argument 

.000 

14 

0 

Byte-allgns  the  current  location  counter. 

.PAGE 

14 

0 

Advances  form  to  top  of  next  page. 

.PRINT 

14 

0 

Prints  specified  message  on  command 
output  deivee. 

.PSECT 

14 

0 

Begins  specified  program  section  having 
specified  attributes. 

.RADIX 

14 

0 

Changes  current  program  radix  to 
specified  radix. 

.RADSO 

14 

0 

Generates  data  block  having  Radix-50 
equivalents  of  specified  character  string 

.REPT 

14 

0 

Begins  repeat  block  and  replicates  It 
according  to  the  value  of  the  specjfled 
expression. 

.SBTTL 

14 

0 

Prints  specified  subtitle  text  as  the 
second  line  of  the  assembly  listing  page 
header. 

.TITLE 

14 

0 

Prints  specified  title  text  as  object 
module  name  In  the  first  line  of  the 
assembly  listing  page  header. 

.WORD 

14 

0 

Generate  successive  word  data  In 
accordance  with  specified  arguments. 

EVEN 


14 


0 


word-allgns  the  currant  location  counter. 
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